Send draft.

POST/api/v1/campaigns/{id}/send

Browse API endpoints

Campaigns / CRM REST API

Scope: campaigns:write

Request: no body.

Response:

Code example

{
  "data": {
    "id": "cmp_xyz789",
    "status": "sending"
  }
}

The audience is resolved BEFORE the campaign flips to sending, so an empty list is surfaced right here as a 400 rather than moving the campaign to sending and reverting it moments later.

Errors specific to this endpoint:

invalid_status: ... - the campaign is not in a status you can send from (already sending, already sent, cancelled, and so on).
channel_unsupported: the API can only send email campaigns (this one is sms) - SMS broadcasts are gated by a role capability the API cannot check.
list_required: ... - the campaign has no list attached, OR the list was archived / moved out of this sub-account after create.
empty_audience: ... - the resolved audience is zero recipients (for example, every contact on the list is opted out or suppressed).

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

Path parameters

id Required

cURL

curl --request POST \
  --url 'https://your-crm.example.com/api/v1/campaigns/ID_HERE/send' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.