Launch a campaign
Move a Draft campaign to Pending and start sending.
POST
https://nextgenpanel.cloudshope.com/api/v1/email/campaigns/{id}/launchMaterialises the send queue for a Draft campaign and hands every recipient to the background sender. The call returns as soon as the queue is built — delivery happens asynchronously.
Poll the analytics endpoint for progress.
Authentication
Send Authorization: Bearer <token>. Any valid API token for the account works.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | Campaign id. |
Request
curl -X POST https://nextgenpanel.cloudshope.com/api/v1/email/campaigns/611/launch \
-H "Authorization: Bearer cs_live_9f2c…"Response
{ "queued": 2 }Errors
| Status | Type | When |
|---|---|---|
| 400 | bad-request | The campaign is not in a launchable state, or has no recipients. |
| 404 | not-found | No campaign with this id on the account. |
| 401 | unauthorized | The Authorization header is missing, malformed or the token is invalid or expired. |
| 403 | forbidden | The token is valid but the account is not allowed to perform this action. |