v1

latestOpenAPI 3.1.02026-07-26359254.7 MB

AI SDR Sequences

Create an AI SDR sequence

<Warning> **Coming soon.** This endpoint will be available by early July 2026. </Warning>

<small>Requires the ai-sdr:write scope (or a broader one that includes it).</small>

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/v3/sequences/ai-sdr

Request body

namestring required

Display name of the sequence

scheduleIdinteger nullable

Id of the send schedule to use

emailAccountsinteger[] nullable

Email account ids to link to the sequence

linkedInAccountsinteger[] nullable

LinkedIn account ids to link to the sequence

offerIdinteger nullable

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

providerLLM'claude' | 'openAi' | 'gemini' | 'mistral' nullable

LLM provider that generates the outreach content for the AI SDR sequence.

playbookIdstring nullable

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).

knowledgeBaseIdinteger nullable

Id of a knowledge base to connect to the sequence

Response

AI SDR sequence created

idinteger

Unique identifier for the sequence

ownerUserIdinteger

Identifier of the user who owns the sequence

namestring

Name of the sequence

createdstring date-time

Sequence creation timestamp with timezone offset

status'new' | 'active' | 'paused'

Current status of the sequence

isArchivedboolean

Indicates if the sequence is archived

health'healthy' | 'stalled' | 'degraded' | 'blocked'

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

scheduleIdinteger

Schedule ID

Example response

{
  "id": 123,
  "ownerUserId": 42,
  "name": "Sales Outreach 2024",
  "status": "active",
  "created": "2024-03-08T14:30:00+00:00",
  "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 are 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
        }
      ]
    }
  ]
}