Email Sequences

Email sequences let you automate multi-step outreach to candidates. Each step in a sequence is sent after a configured delay, stopping when the candidate responds.

Create a sequence

POST /v1/email-sequence
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "name": "Senior Engineer Outreach",
  "steps": [
    {
      "subject": "Exciting opportunity at {{company}}",
      "body": "Hi {{firstName}}, I came across your profile...",
      "delayDays": 0
    },
    {
      "subject": "Following up",
      "body": "Hi {{firstName}}, just wanted to check in...",
      "delayDays": 3
    },
    {
      "subject": "Last touch",
      "body": "Hi {{firstName}}, I'll keep this brief...",
      "delayDays": 7
    }
  ]
}

Enroll a candidate

POST /v1/email-sequence/:sequenceId/enroll
Authorization: Bearer <token>
Content-Type: application/json
 
{
  "candidateId": "prof_01abc...",
  "variables": {
    "company": "Acme Corp",
    "firstName": "Jane"
  }
}

Template variables

Use {{variableName}} syntax in subject and body. Built-in variables:

Variable	Value
`{{firstName}}`	Candidate’s first name
`{{lastName}}`	Candidate’s last name
`{{email}}`	Candidate’s email
`{{company}}`	Sending company name

Custom variables can be passed in the variables object at enrollment time.

Stop a sequence

Sequences auto-stop on reply. To manually stop:

POST /v1/email-sequence/:sequenceId/unenroll
Content-Type: application/json
 
{ "candidateId": "prof_01abc..." }

Connected email accounts

Sequences send from your connected email accounts. Set up email accounts under /v1/email-account before creating sequences. See the API Reference for full schema.