Create an AI SDR sequence

curl --request POST \
  --url https://api.reply.io/v3/sequences/ai-sdr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "sequenceStructureSetup": {
    "generatedStepTypes": [],
    "generateConditional": true,
    "numberOfSteps": 5
  },
  "scheduleId": 2,
  "emailAccounts": [
    2
  ],
  "linkedInAccounts": [
    2
  ],
  "offerId": 2,
  "offerGenerationInputs": {
    "companyName": "<string>",
    "companyDescription": "<string>",
    "icp": "<string>",
    "reasonForOutreach": "<string>",
    "caseStudies": [
      "<string>"
    ],
    "painPoints": [
      "<string>"
    ],
    "proofPoints": [
      "<string>"
    ],
    "valuePropositions": [
      "<string>"
    ],
    "callToActions": [
      "<string>"
    ]
  },
  "toneOfVoice": {},
  "personalizationPoints": {
    "basicResearch": true,
    "companyResearch": {
      "description": true,
      "mission": true,
      "techStack": true,
      "tenKReport": true,
      "recentReportForInvestors": true,
      "financialReport": true,
      "fundraisingResearch": true,
      "challenges": true,
      "recentNews": true,
      "predictChallengesAndCompetitors": true,
      "productsServicesDeepDive": true,
      "mergersAcquisitions": true,
      "customerReviews": true
    },
    "prospectResearch": {
      "aboutSection": true,
      "hobbiesInterests": true,
      "quotes": true,
      "achievements": true,
      "careerSummary": true,
      "jobResponsibilitiesInCurrentCompany": true,
      "achievementsInCurrentCompany": true
    },
    "industryResearch": {
      "recentIndustryNews": true,
      "industryTrends": true,
      "competitorsOverviewNews": true
    },
    "contactFields": {
      "enabled": true,
      "defaultFields": [],
      "customFieldIds": [
        2
      ]
    },
    "customResearch": {
      "enabled": true,
      "instructions": "<string>"
    }
  },
  "playbookId": "<string>",
  "knowledgeBaseId": 2,
  "intentSignals": [
    {
      "postEngagers": {
        "monitorProfiles": {
          "profiles": [
            {
              "linkedInUrl": "<string>"
            }
          ]
        },
        "monitorPosts": {
          "postUrls": [
            "<string>"
          ]
        }
      },
      "competitorFollowers": {
        "linkedInUrls": [
          "<string>"
        ],
        "entitiesToFind": 300
      },
      "technologyUsed": {
        "industryId": 2,
        "technologies": [
          "<string>"
        ],
        "useAndLogicInTechnologies": true,
        "entitiesToFind": 250
      },
      "jobHiring": {
        "keyword": "<string>",
        "industries": [
          2
        ],
        "entitiesToFind": 250
      }
    }
  ]
}
'

{
  "id": 123,
  "ownerUserId": 42,
  "name": "Sales Outreach 2024",
  "created": "2024-03-08T14:30:00+00:00",
  "status": "active",
  "isArchived": false,
  "health": "degraded",
  "scheduleId": 1,
  "emailAccounts": [
    {
      "id": 1,
      "email": "sales@company.com"
    },
    {
      "id": 2,
      "email": "outreach@company.com"
    }
  ],
  "linkedInAccounts": [
    {
      "id": 42,
      "name": "John Doe",
      "profileUrl": "https://www.linkedin.com/in/johndoe",
      "status": "enabled"
    }
  ],
  "settings": {
    "emailsCountPerDay": 50,
    "daysToFinishProspect": 14,
    "emailSendingDelaySeconds": 30,
    "dailyThrottling": 200,
    "disableOpensTracking": false,
    "repliesHandlingType": "markAsFinished",
    "enableLinksTracking": true
  },
  "steps": [
    {
      "id": 1323,
      "type": "email",
      "delayInMinutes": 0,
      "executionMode": "automatic",
      "variants": [
        {
          "id": 1,
          "subject": "Quick question about {{companyName}}",
          "message": "<p>Hi {{firstName}},</p><p>I noticed you're leading initiatives at {{companyName}} and wanted to reach out.</p><p>Best regards, John</p>"
        }
      ]
    },
    {
      "id": 43432,
      "type": "linkedIn",
      "actionType": "message",
      "delayInMinutes": 2880,
      "executionMode": "automatic",
      "variants": [
        {
          "id": 2,
          "message": "Hi {{firstName}}, I noticed your great work at {{companyName}}. Would love to connect!",
          "isEnabled": true
        }
      ]
    }
  ]
}

AI SDR Sequences

Create an AI SDR sequence

Coming soon. This endpoint will be available by mid June 2026.

Creates a new AI SDR sequence with its full AI SDR settings payload. The sequence is seeded either from a saved offer (offerId) or from inline offer-context inputs (offerGenerationInputs) — exactly one is required.

Sequence steps are generated by the AI SDR — clients do not pass steps here. Generic sequence fields (name, scheduleId, settings, emailAccounts, linkedInAccounts) are accepted and applied after the AI SDR-specific setup.

Requires the AI SDR feature on the caller’s team.

POST

sequences

ai-sdr

Create an AI SDR sequence

curl --request POST \
  --url https://api.reply.io/v3/sequences/ai-sdr \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "sequenceStructureSetup": {
    "generatedStepTypes": [],
    "generateConditional": true,
    "numberOfSteps": 5
  },
  "scheduleId": 2,
  "emailAccounts": [
    2
  ],
  "linkedInAccounts": [
    2
  ],
  "offerId": 2,
  "offerGenerationInputs": {
    "companyName": "<string>",
    "companyDescription": "<string>",
    "icp": "<string>",
    "reasonForOutreach": "<string>",
    "caseStudies": [
      "<string>"
    ],
    "painPoints": [
      "<string>"
    ],
    "proofPoints": [
      "<string>"
    ],
    "valuePropositions": [
      "<string>"
    ],
    "callToActions": [
      "<string>"
    ]
  },
  "toneOfVoice": {},
  "personalizationPoints": {
    "basicResearch": true,
    "companyResearch": {
      "description": true,
      "mission": true,
      "techStack": true,
      "tenKReport": true,
      "recentReportForInvestors": true,
      "financialReport": true,
      "fundraisingResearch": true,
      "challenges": true,
      "recentNews": true,
      "predictChallengesAndCompetitors": true,
      "productsServicesDeepDive": true,
      "mergersAcquisitions": true,
      "customerReviews": true
    },
    "prospectResearch": {
      "aboutSection": true,
      "hobbiesInterests": true,
      "quotes": true,
      "achievements": true,
      "careerSummary": true,
      "jobResponsibilitiesInCurrentCompany": true,
      "achievementsInCurrentCompany": true
    },
    "industryResearch": {
      "recentIndustryNews": true,
      "industryTrends": true,
      "competitorsOverviewNews": true
    },
    "contactFields": {
      "enabled": true,
      "defaultFields": [],
      "customFieldIds": [
        2
      ]
    },
    "customResearch": {
      "enabled": true,
      "instructions": "<string>"
    }
  },
  "playbookId": "<string>",
  "knowledgeBaseId": 2,
  "intentSignals": [
    {
      "postEngagers": {
        "monitorProfiles": {
          "profiles": [
            {
              "linkedInUrl": "<string>"
            }
          ]
        },
        "monitorPosts": {
          "postUrls": [
            "<string>"
          ]
        }
      },
      "competitorFollowers": {
        "linkedInUrls": [
          "<string>"
        ],
        "entitiesToFind": 300
      },
      "technologyUsed": {
        "industryId": 2,
        "technologies": [
          "<string>"
        ],
        "useAndLogicInTechnologies": true,
        "entitiesToFind": 250
      },
      "jobHiring": {
        "keyword": "<string>",
        "industries": [
          2
        ],
        "entitiesToFind": 250
      }
    }
  ]
}
'

{
  "id": 123,
  "ownerUserId": 42,
  "name": "Sales Outreach 2024",
  "created": "2024-03-08T14:30:00+00:00",
  "status": "active",
  "isArchived": false,
  "health": "degraded",
  "scheduleId": 1,
  "emailAccounts": [
    {
      "id": 1,
      "email": "sales@company.com"
    },
    {
      "id": 2,
      "email": "outreach@company.com"
    }
  ],
  "linkedInAccounts": [
    {
      "id": 42,
      "name": "John Doe",
      "profileUrl": "https://www.linkedin.com/in/johndoe",
      "status": "enabled"
    }
  ],
  "settings": {
    "emailsCountPerDay": 50,
    "daysToFinishProspect": 14,
    "emailSendingDelaySeconds": 30,
    "dailyThrottling": 200,
    "disableOpensTracking": false,
    "repliesHandlingType": "markAsFinished",
    "enableLinksTracking": true
  },
  "steps": [
    {
      "id": 1323,
      "type": "email",
      "delayInMinutes": 0,
      "executionMode": "automatic",
      "variants": [
        {
          "id": 1,
          "subject": "Quick question about {{companyName}}",
          "message": "<p>Hi {{firstName}},</p><p>I noticed you're leading initiatives at {{companyName}} and wanted to reach out.</p><p>Best regards, John</p>"
        }
      ]
    },
    {
      "id": 43432,
      "type": "linkedIn",
      "actionType": "message",
      "delayInMinutes": 2880,
      "executionMode": "automatic",
      "variants": [
        {
          "id": 2,
          "message": "Hi {{firstName}}, I noticed your great work at {{companyName}}. Would love to connect!",
          "isEnabled": true
        }
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

Authenticate every request with a Bearer token. Pass your Reply API key in the Authorization header:

Authorization: Bearer <your-api-key>

Get your API key from the Reply dashboard: Settings → API Key.

Body

application/json

Create a new AI SDR sequence with its full AI SDR settings. Generic sequence fields (name, scheduleId, settings, emailAccounts, linkedInAccounts) are accepted here too — sequence steps are NOT, because the AI SDR generates steps automatically.

Exactly one of offerId or offerGenerationInputs must be provided.

At most one intent signal per type is allowed.

name

string

required

Display name of the sequence

Required string length: 1 - 255

sequenceStructureSetup

Sequence structure setup · object

required

Shape of the sequence steps the AI SDR should generate on create.

Show child attributes

scheduleId

integer | null

Id of the send schedule to use

Required range: x >= 1

settings

Sequence Settings · object

Generic sequence settings (throttling, tracking, replies handling). Optional — sensible defaults are applied when omitted.

Show child attributes

emailAccounts

integer<int64>[] | null

Email account ids to link to the sequence

Required range: x >= 1

linkedInAccounts

integer[] | null

LinkedIn account ids to link to the sequence

Required range: x >= 1

offerId

integer<int64> | null

Id of an existing offer to seed the sequence from. Mutually exclusive with offerGenerationInputs.

Required range: x >= 1

offerGenerationInputs

Offer generation inputs · object

Inline offer-context inputs. Mutually exclusive with offerId.

Show child attributes

toneOfVoice

Tone of voice settings (request) · object

Tone-of-voice configuration. Omitted fields fall back to defaults (English (US), Confident, Medium, Man).

Show child attributes

providerLLM

enum<string>

LLM provider that generates the outreach content. Defaults to claude when omitted.

Available options:

claude,

openAi,

gemini,

mistral

personalizationPoints

Personalization points · object

Research signals the AI SDR is allowed to use in personalized messages

Show child attributes

autopilot

Autopilot settings (create) · object

Autopilot configuration applied immediately after sequence creation

Show child attributes

playbookId

string | null

Composite playbook id ({prefix}-{numericId}) to attach to the sequence. Prefix encodes the playbook scope: g for global, o for organization, t for team (e.g. g-1, o-42, t-7).

Minimum string length: 1

knowledgeBaseId

integer<int64> | null

Id of a knowledge base to connect to the sequence

Required range: x >= 1

approvalMode

Approval mode (create) · object

Initial approval-mode setting. Cannot be changed via the AI SDR sequence PATCH — use PUT .../approval-mode after creation.

Show child attributes

intentSignals

Intent signal · object[] | null

Intent signals to attach. At most one per type.

Show child attributes

Response

AI SDR sequence created

AI SDR sequence creation response — extends the generic sequence response with the AI SDR-specific settings under aiSdr.

integer

read-only

Unique identifier for the sequence

ownerUserId

integer

read-only

Identifier of the user who owns the sequence

name

string

Name of the sequence

created

string<date-time>

read-only

Sequence creation timestamp with timezone offset

status

enum<string>

read-only

Current status of the sequence

Available options:

new,

active,

paused

isArchived

boolean

read-only

Indicates if the sequence is archived

health

enum<string>

read-only

Overall health status of the sequence. Indicates whether the sequence can operate normally or has issues that need attention.

healthy — Sequence is functioning normally with no issues
stalled — Sequence has stalled and is not progressing
degraded — Sequence is running but with reduced effectiveness
blocked — Sequence cannot proceed due to critical issues

Available options:

healthy,

stalled,

degraded,

blocked

scheduleId

integer

Schedule ID

emailAccounts

object[]

Email accounts used to send emails for this sequence

Show child attributes

linkedInAccounts

LinkedIn Account · object[]

LinkedIn accounts linked to this sequence

Show child attributes

settings

Sequence Settings · object

Settings configuration for a sequence

Show child attributes

steps

Array of sequence steps

Email step with variant configuration

Show child attributes

aiSdr

AI SDR sequence settings · object

AI SDR-specific settings of a sequence. Returned by GET .../settings and PATCH .../settings. Generic sequence fields (name, schedule, accounts, etc.) come from the generic GET /v3/sequences/{id} and are NOT included here.

Show child attributes

Regenerate preview for many contacts Read AI SDR sequence settings