On this page
POST/campaigns/:campaignId/start
Credits: 0
LinkedIn risk: Medium (starts real outbound pacing )
Purpose
Start outreach for a ready campaign, or resume a paused one. Same as the dashboard Start / Resume controls (assigned AI agent, connected LinkedIn accounts, at least one lead). Unlike the dashboard Start control, this endpoint does not restart COMPLETED / DONE campaigns (409 instead).
| Current status | Behavior |
|---|---|
READY_TO_SEND | Start → CAMPAIGN_IN_PROGRESS (action: started) |
FAILED with leads | Start → CAMPAIGN_IN_PROGRESS (action: started) |
CAMPAIGN_PAUSED | Resume → CAMPAIGN_IN_PROGRESS (action: resumed) |
CAMPAIGN_PAUSED + add-more-leads import active | 409 conflict (wait for import to finish) |
CAMPAIGN_IN_PROGRESS | No-op success (action: noop) |
Already at 20 active (CAMPAIGN_IN_PROGRESS) campaigns | 409 conflict with details.code: ACTIVE_CAMPAIGN_LIMIT |
Agent sendWhen is missing or incomplete (no days, hours, or timezone) | 409 conflict with details.code: SCHEDULE_NOT_SET |
COMPLETED / DONE | 409 conflict |
FAILED with no leads | 409 conflict |
The agent (assignedTemplateId) must already be set — via the dashboard or POST /campaigns/:id/template. This endpoint does not create or edit agents. After a clear (templateId: null), start returns 400 until an agent is assigned again.
Request
POST /campaigns/search_abc/start
X-API-Key: sk_live_...
Body must be empty or {}. Any other fields → 400 validation_error.
Response 200
{
"campaignId": "search_abc",
"action": "started",
"status": "CAMPAIGN_IN_PROGRESS",
"campaign": {
"id": "search_abc",
"name": "Broker outreach",
"status": "CAMPAIGN_IN_PROGRESS",
"totalLeads": 9,
"assignedTemplateId": "tmpl_…",
"stats": {}
}
}
| Field | Notes |
|---|---|
action | started | resumed | noop |
status | Campaign status after the call |
campaign | Same allowlisted shape as GET /campaigns/:id |
Errors
| Code | When |
|---|---|
validation_error | Non-empty body, or no assigned agent |
not_found | Unknown campaign / template |
conflict | Wrong status (e.g. completed, failed with no leads, still preparing, more leads still being imported, active campaign limit — details.code may be ACTIVE_CAMPAIGN_LIMIT — or incomplete send schedule — details.code is SCHEDULE_NOT_SET) |
account_disconnected | Template LinkedIn account not connected |
plan_required | Plan inactive (normally blocked at auth) |
MCP
Tool: start_campaign — arg: campaignId. Confirm with the user before starting real outreach.