Skip to main content
POST
/
v3
/
sequences
/
{id}
/
start
Start a sequence
curl --request POST \
  --url https://api.reply.io/v3/sequences/{id}/start \
  --header 'Authorization: Bearer <token>'
{ "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.

Path Parameters

​
id
integer
required

Sequence Id

Required range: x >= 1

Response

Sequence is now active. Returned both when the sequence was just started and when it was already active (idempotent).

​
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