On this page

POST/campaigns/:campaignId/pause

Credits: 0
LinkedIn risk: Low (stops dispatch; does not send LinkedIn traffic)


Purpose

Pause an in-progress campaign. Same rules as the dashboard Pause control (cancels queued outbound work for that campaign and clears outbound queue flags on leads).

Current statusBehavior
CAMPAIGN_IN_PROGRESSPause → CAMPAIGN_PAUSED (action: paused)
CAMPAIGN_PAUSEDNo-op success (action: noop)
Other409 conflict
Extension import active (extensionStatus: FINDING_LEADS)Pause still succeeds — outreach stops; lead import keeps finishing in the background

Request

POST /campaigns/search_abc/pause
X-API-Key: sk_live_...

Body must be empty or {}. Any other fields → 400 validation_error.


Response 200

{
  "campaignId": "search_abc",
  "action": "paused",
  "status": "CAMPAIGN_PAUSED",
  "campaign": {
    "id": "search_abc",
    "name": "Broker outreach",
    "status": "CAMPAIGN_PAUSED",
    "totalLeads": 9,
    "assignedTemplateId": "tmpl_…",
    "stats": {}
  }
}
FieldNotes
actionpaused | noop
statusAlways CAMPAIGN_PAUSED on success
campaignSame allowlisted shape as GET /campaigns/:id

Errors

CodeWhen
validation_errorNon-empty body
not_foundUnknown campaign
conflictNot in progress (resume/start is blocked while leads are still being imported)
upstream_unavailableUnexpected pause failure — retry

MCP

Tool: pause_campaign — arg: campaignId.