Cancel Campaign

Cancels a campaign that has not yet completed. Sendiee marks every pending / queued recipient as skipped, so the message worker immediately stops draining the rest of the audience.

POST/v2.0/campaigns/{campaignId}/cancel

Already-accepted messages cannot be recalled

Any message Meta has already accepted (status sent /delivered / read) will still arrive at the recipient — the WhatsApp Cloud API has no recall mechanism. Cancel as early as possible to maximise the number of pending recipients we can stop.

Path Parameters

Path

Parameter	Type	Required	Description
campaignId	string	Required	Campaign id returned by POST /v2.0/campaigns

Example

curl -X POST https://api.sendiee.com/v2.0/campaigns/664a.../cancel \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "success": true,
  "message": "Campaign cancelled. Pending recipients have been skipped.",
  "data": {
    "campaignId": "664a...",
    "status": "cancelled",
    "cancelledAt": "2026-04-29T05:18:42.000Z",
    "skippedRemaining": 482
  }
}

Already terminal (409)

{
  "error": true,
  "code": "CAMPAIGN_NOT_CANCELLABLE",
  "message": "Campaign is already in terminal status \"completed\" and cannot be cancelled.",
  "details": {
    "currentStatus": "completed"
  }
}

Not Found (404)

{
  "error": true,
  "code": "CAMPAIGN_NOT_FOUND",
  "message": "Campaign not found"
}