Skip to main content
POST
/
v3
/
sequences
Create a sequence
curl --request POST \
  --url https://api.reply.io/v3/sequences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "name": "Sales Outreach 2024",
  "scheduleId": 1,
  "emailAccounts": [
    101,
    102
  ],
  "linkedInAccounts": [
    42
  ],
  "settings": {
    "emailsCountPerDay": 50,
    "daysToFinishProspect": 14,
    "emailSendingDelaySeconds": 30,
    "dailyThrottling": 200,
    "useDailyThrottling": true,
    "disableOpensTracking": false,
    "repliesHandlingType": "markAsFinished",
    "enableLinksTracking": true
  },
  "steps": [
    {
      "type": "email",
      "delayInMinutes": 0,
      "executionMode": "automatic",
      "variants": [
        {
          "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</p>"
        }
      ]
    },
    {
      "type": "linkedIn",
      "actionType": "message",
      "delayInMinutes": 1440,
      "executionMode": "automatic",
      "variants": [
        {
          "message": "Hi {{firstName}}, would love to connect!",
          "isEnabled": true
        }
      ]
    }
  ]
}
EOF
{
  "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
        }
      ]
    }
  ],
  "issues": [
    {
      "type": "emailAccountSendingBlocked"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.reply.io/llms.txt

Use this file to discover all available pages before exploring further.

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 sequence

name
string
required

Name of the sequence

scheduleId
integer

ID of the schedule to use

Required range: x >= 1
settings
Sequence Settings · object

Settings configuration for a sequence

emailAccounts
integer<int64>[]

Array of email account IDs

Required range: x >= 1
linkedInAccounts
integer[]

Array of LinkedIn account IDs

Required range: x >= 1
steps
(Email · object | LinkedIn Message · object | LinkedIn Connect · object | LinkedIn InMail · object | LinkedIn View Profile · object | LinkedIn Endorse Skills · object | LinkedIn Voice Message · object | LinkedIn Like Recent Posts · object | LinkedIn Follow Profile · object | Call · object | SMS · object | WhatsApp · object | Zapier · object | Task · object | Condition · object)[]

Array of sequence steps. Select a step type to see its configuration.

Email step with variant configuration

Response

Sequence created successfully

id
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

linkedInAccounts
LinkedIn Account · object[]

LinkedIn accounts linked to this sequence

settings
Sequence Settings · object

Settings configuration for a sequence

steps
(Email · object | LinkedIn Message · object | LinkedIn Connect · object | LinkedIn InMail · object | LinkedIn View Profile · object | LinkedIn Endorse Skills · object | LinkedIn Voice Message · object | LinkedIn Like Recent Posts · object | LinkedIn Follow Profile · object | Call · object | SMS · object | WhatsApp · object | Zapier · object | Task · object | Condition · object)[]

Array of sequence steps

Email step with variant configuration

issues
object[] | null
read-only

List of health issues affecting this sequence. Only present in the detail response. Null when the sequence is healthy.