On this page

POST/campaigns/:campaignId/start

Unified start or resume. 0 credits. Rate class: campaign_control.

Behavior

Current status	Result	Body
`READY_TO_SEND`	Starts → `CAMPAIGN_IN_PROGRESS`	`templateId` required
`CAMPAIGN_PAUSED`	Resumes → `CAMPAIGN_IN_PROGRESS`	uses `assignedTemplateId`; body optional
other	400 `validation_error`	—

POST /campaigns/search-xyz/start
X-API-Key: sk_live_...
Content-Type: application/json

{
  "templateId": "tmpl_abc"
}

{
  "campaignId": "search-xyz",
  "status": "CAMPAIGN_IN_PROGRESS",
  "action": "started"
}

action is "started" or "resumed". Create agents/templates in the NotiQ app, then pass templateId.

Error code	When
`not_found`	Unknown campaign or template
`account_disconnected`	Gmail missing/disconnected on agent
`upstream_unavailable`	Temporary failure

Tool: start_campaign.