API ReferenceCampaigns

Start a campaign

POST /api/v1/campaign/{id}/start — begin dispatching calls.

POST /api/v1/campaign/{campaign_id}/start

Move the campaign from created to running and begin dispatching contacts.

Response

200 OK with the campaign in state="running".

curl -X POST https://dashboard.zoxa.ai/api/v1/campaign/7/start \
  -H "X-API-Key: zsk_..."

Status	`detail`	When
`400`	`"You must configure telephony first..."`	Org has no telephony configuration.
`402`	quota message	Org over monthly quota.
`404`	`"Campaign not found"`	Id not in your org.

Update a campaign

PATCH /api/v1/campaign/{id} — change name, concurrency, retry, schedule, or circuit-breaker. Locked once completed, failed, or archived.

Pause a campaign

POST /api/v1/campaign/{id}/pause — stop dispatching new calls. In-flight calls finish normally.