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 statusBehavior
READY_TO_SENDStart → CAMPAIGN_IN_PROGRESS (action: started)
FAILED with leadsStart → CAMPAIGN_IN_PROGRESS (action: started)
CAMPAIGN_PAUSEDResume → CAMPAIGN_IN_PROGRESS (action: resumed)
CAMPAIGN_PAUSED + add-more-leads import active409 conflict (wait for import to finish)
CAMPAIGN_IN_PROGRESSNo-op success (action: noop)
Already at 20 active (CAMPAIGN_IN_PROGRESS) campaigns409 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 / DONE409 conflict
FAILED with no leads409 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": {}
  }
}
FieldNotes
actionstarted | resumed | noop
statusCampaign status after the call
campaignSame allowlisted shape as GET /campaigns/:id

Errors

CodeWhen
validation_errorNon-empty body, or no assigned agent
not_foundUnknown campaign / template
conflictWrong 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_disconnectedTemplate LinkedIn account not connected
plan_requiredPlan inactive (normally blocked at auth)

MCP

Tool: start_campaign — arg: campaignId. Confirm with the user before starting real outreach.