> ## 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.

# Launch SMS campaign

> POST /v1/sms/campaigns/:id/launch

Launches a `draft` or `scheduled` SMS campaign immediately.

## Request

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

No request body.

## Response

`200 OK`:

```json theme={null}
{
  "campaign_id": "smsc_a1b2c3d4",
  "status": "running",
  "total_count": 100,
  "pending_count": 100,
  "delivered_count": 0,
  "failed_count": 0
}
```

The campaign transitions to `status: running` and begins sending. Track progress with [Get SMS campaign](/api-reference/sms/campaigns-get).

## Errors

| Code                       | Cause                             |
| -------------------------- | --------------------------------- |
| `campaign_not_found`       | ID does not exist or is not yours |
| `campaign_already_running` | Already launched                  |
| `campaign_already_done`    | Already finished                  |
| `campaign_no_recipients`   | Empty recipient list              |
