Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
sequences
curl -X POST "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/sequences" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Quick question, {{firstName}}",
    "body": "Hi {{firstName}},\n\nI noticed {{company}} recently expanded...",
    "name": "Initial outreach",
    "delayDays": 0,
    "delayHours": 0,
    "sendOnlyIfNoReply": false
  }'

{
  "data": {
    "id": "seq_001",
    "campaignId": "cmp_abc123",
    "stepNumber": 1,
    "name": "Initial outreach",
    "subject": "Quick question, {{firstName}}",
    "body": "Hi {{firstName}},\n\nI noticed {{company}} recently expanded...",
    "delayDays": 0,
    "delayHours": 0,
    "sendOnlyIfNoReply": false,
    "createdAt": "2025-01-10T08:00:00",
    "updatedAt": "2025-01-10T08:00:00"
  }
}

​
Path Parameters

​
campaign_id
string
required
The unique identifier of the campaign.

​
Body Parameters

​
subject
string
required
Email subject line. Supports template variables and spin syntax.
​
body
string
required
Email body content. Supports template variables and spin syntax.
​
name
string
Optional name for the sequence step (e.g., “Initial outreach”, “Follow-up”).
​
delayDays
integer
default:"0"
Number of days to wait after the previous step before sending.
​
delayHours
integer
default:"0"
Additional hours to wait (combined with delayDays).
​
sendOnlyIfNoReply
boolean
default:"true"
If true, skip this step if the lead has already replied to a previous step.

​
Response

Returns the created sequence step object. 
curl -X POST "https://api.foxreach.io/api/v1/campaigns/cmp_abc123/sequences" \
  -H "X-API-Key: otr_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Quick question, {{firstName}}",
    "body": "Hi {{firstName}},\n\nI noticed {{company}} recently expanded...",
    "name": "Initial outreach",
    "delayDays": 0,
    "delayHours": 0,
    "sendOnlyIfNoReply": false
  }'

{
  "data": {
    "id": "seq_001",
    "campaignId": "cmp_abc123",
    "stepNumber": 1,
    "name": "Initial outreach",
    "subject": "Quick question, {{firstName}}",
    "body": "Hi {{firstName}},\n\nI noticed {{company}} recently expanded...",
    "delayDays": 0,
    "delayHours": 0,
    "sendOnlyIfNoReply": false,
    "createdAt": "2025-01-10T08:00:00",
    "updatedAt": "2025-01-10T08:00:00"
  }
}

​
Errors

StatusDescription
400Campaign is active — pause it first
400Invalid spin syntax in subject or body
404Campaign not found

​
Rate Limit

  • 100 requests per minute, per API key. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).
For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.