# Schedule a campaign `POST /api/v1/campaigns/{id}/send` Schedules a prepared campaign for immediate or future delivery. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Campaigns → Write**. ## Headers - `X-Sport-Id` (integer, required) — The sport ID from [List sports](/api/sports/list.md). Use the sport the record belongs to. ## Path parameters - `id` (integer, required) — ID of the campaign. ## Body parameters - `scheduled_at` (integer, string, or null) — Use a future Unix timestamp in seconds, now, or null. Omission schedules immediate delivery. Use [Build a campaign recipient list](/api/campaigns/build-recipients.md) before scheduling. ## Request Set ASDINCLOUD_API_KEY and any variables named in the example before running it. ```sh curl --request POST \ --url "https://api.asdincloud.com/api/v1/campaigns/${ID:?Set ID}/send" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --header "X-Sport-Id: ${SPORT_ID:?Set SPORT_ID}" \ --header "Content-Type: application/json" \ --data '{"scheduled_at":"now"}' ``` ## Response **200 OK** Returns the current campaign and queue status. Delivery is asynchronous. Example with fictional data and selected fields. ```json { "status": "scheduled", "campaign_id": 24, "tenant_id": 11, "scheduled_at": 1794564000, "job": { "status": "pending" } } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks the required permission. - `404` — The requested record was not found. - `409` — The campaign's current state does not allow this operation. - `422` — The campaign is not ready, it has no recipients, or the scheduled time is invalid. - `500` — The campaign operation could not be completed.