Campaigns

Send a campaign

POST /api/v1/campaigns/{uid}/run

Starts sending now. The launch rules of the account apply.

Parameters
uid string required path
The campaign's uid.
Responses
200 The campaign is sending.
401 The token is missing or wrong (Unauthenticated.), or its user may not act on this object (Unauthorized). Without the Accept: application/json header, a missing or wrong token answers with a redirect to the sign-in page instead.
404 No campaign has this uid.
422 The account may not launch this campaign now; the message says why.
Send a campaign
1 2 3
curl -X POST 'https://your-domain/api/v1/campaigns/6adaabd2b4753/run' \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
Response
{
    "status": "success",
    "message": "The campaign was launched",
    "campaign": {
        "id": 1,
        "uid": "6adaabd2b4753",
        "name": "November newsletter",
        "list": "Newsletter",
        "segment": "",
        "from_email": "hello@example.com",
        "from_name": "Example Team",
        "remind_message": null,
        "status": "queued",
        "created_at": "2026-11-01T05:29:19.000000Z",
        "updated_at": "2026-11-14T10:00:00.000000Z"
    }
}