POST/campaigns/:campaignId/pause

Pause an in-progress campaign. Same behavior as the dashboard Pause control — stops queued outreach for that campaign. Does not send LinkedIn traffic.

0 credits. To resume later, call POST …/start.

Current statusBehavior
CAMPAIGN_IN_PROGRESSPause → CAMPAIGN_PAUSED (action: paused)
CAMPAIGN_PAUSEDNo-op success (action: noop)
Other409 conflict

Also 409 conflict if more leads are still being added — wait for that to finish, then retry.

POST /campaigns/search_abc/pause
X-API-Key: sk_live_...
Content-Type: application/json
{}

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

{
  "campaignId": "search_abc",
  "action": "paused",
  "status": "CAMPAIGN_PAUSED",
  "campaign": {
    "id": "search_abc",
    "name": "Q3 outbound",
    "status": "CAMPAIGN_PAUSED",
    "totalLeads": 120,
    "assignedTemplateId": "tpl_...",
    "stats": {
      "connectionRequestsSent": 80,
      "connectionRequestsAccepted": 20,
      "acceptanceRate": 25.0,
      "messagesSent": 40,
      "repliesReceived": 8,
      "replyRate": 20.0
    }
  }
}
FieldValues
campaignIdSame as path
actionpaused | noop
statusAlways CAMPAIGN_PAUSED on success
campaignSame shape as GET /campaigns/:id
Error codeWhen
validation_errorBody has extra fields
not_foundUnknown campaign
conflictNot in progress, or more leads are still being added
rate_limitedOver the start/pause limit (30 / minute)
upstream_unavailableTemporary failure — retry

MCP: pause_campaign (campaignId only).