Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaignId}
/
schedule
Schedule Campaign
curl --request POST \
  --url https://api.sequenzy.com/api/v1/campaigns/{campaignId}/schedule \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scheduledAt": "<string>",
  "targetLists": {},
  "sendTimeOptimization": true,
  "spreadOverHours": 123
}
'
{
  "success": true,
  "message": "Campaign scheduled for 2026-06-01T14:00:00.000Z",
  "scheduledAt": "2026-06-01T14:00:00.000Z",
  "jobId": "mock-job-id",
  "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review",
  "campaign": {
    "id": "camp_abc123",
    "name": "April Launch",
    "subject": "A quick update",
    "status": "scheduled",
    "labels": ["edm", "launch"],
    "scheduledAt": "2026-06-01T14:00:00.000Z",
    "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
    "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
  }
}
Schedule a draft or already scheduled campaign for a future send time. The campaign must have a sender profile whose sending domain is verified. Campaigns that require safety review are held in waiting_approval and are scheduled after an admin approves them.

​
Request

​
campaignId
string
required
Campaign ID.
​
scheduledAt
string
required
Future ISO 8601 send time.
​
targetLists
object
Optional targeting object. Omit this to reuse saved campaign targeting, or to default to all active subscribers.
​
sendTimeOptimization
boolean
Whether to use send-time optimization.
​
spreadOverHours
number
Spread delivery over 1-72 hours. When set, spread delivery takes precedence over send-time optimization.
curl -X POST "https://api.sequenzy.com/api/v1/campaigns/camp_abc123/schedule" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledAt": "2026-06-01T14:00:00Z",
    "targetLists": {
      "type": "all"
    }
  }'

​
Responses

{
  "success": true,
  "message": "Campaign scheduled for 2026-06-01T14:00:00.000Z",
  "scheduledAt": "2026-06-01T14:00:00.000Z",
  "jobId": "mock-job-id",
  "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review",
  "campaign": {
    "id": "camp_abc123",
    "name": "April Launch",
    "subject": "A quick update",
    "status": "scheduled",
    "labels": ["edm", "launch"],
    "scheduledAt": "2026-06-01T14:00:00.000Z",
    "url": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123",
    "previewUrl": "https://sequenzy.com/dashboard/company/comp_abc123/campaign/camp_abc123?step=review"
  }
}