Skip to main content
DELETE
/
v1
/
sms
/
campaigns
/
{campaign_id}
Delete SMS campaign
curl --request DELETE \
  --url https://api.nixflex.com/v1/sms/campaigns/{campaign_id}
Cancels a scheduled or running campaign. Already-sent messages cannot be recalled.

Request

curl -X DELETE https://api.nixflex.com/v1/sms/campaigns/smsc_a1b2c3d4 \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"

Response

200 OK:
{
  "campaign_id": "smsc_a1b2c3d4",
  "deleted": true,
  "cancelled_count": 47
}
cancelled_count is the number of pending recipients that will not be messaged. Already-sent messages remain delivered.

Behaviour

  • Scheduled campaign: cancels before launch. Nothing is sent.
  • Running campaign: stops further sends. Already-queued messages may still go through (Twilio is faster than our cancel signal).
  • Done campaign: returns 400 — nothing to cancel.

Errors

CodeCause
campaign_not_foundID does not exist or is not yours
campaign_already_doneAlready finished