> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nixflex.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete SMS campaign

> DELETE /v1/sms/campaigns/:id

Cancels a `scheduled` or `running` campaign. Already-sent messages cannot be recalled.

## Request

```bash theme={null}
curl -X DELETE https://api.nixflex.com/v1/sms/campaigns/smsc_a1b2c3d4 \
  -H "Authorization: Bearer KEY_ID:KEY_SECRET"
```

## Response

`200 OK`:

```json theme={null}
{
  "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

| Code                    | Cause                             |
| ----------------------- | --------------------------------- |
| `campaign_not_found`    | ID does not exist or is not yours |
| `campaign_already_done` | Already finished                  |