Launch Campaign
Launch a campaign to start reaching contacts.
POST
/campaigns/{campaign_id}/launchLaunch the campaign. Begins calling or messaging contacts based on the campaign type.
Path Parameters
Campaign ID
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaign_id | string | Yes | Campaign ID (must be in draft status) |
Response 200
{
"id": "camp_a1b2c3d4",
"status": "running",
"started_at": "2026-03-07T14:30:00Z",
"total_contacts": 150,
"message": "Campaign launched successfully"
}Prerequisites
Before launching, ensure:
- Campaign has at least one contact
- Agent exists and is properly configured
- Sufficient wallet balance for the campaign
- If voice campaign: agent has
voiceEnabled: true
Errors
| Code | Description |
|---|---|
401 | Missing or invalid authentication |
402 | Insufficient balance |
404 | Campaign not found |
409 | Campaign is not in draft status |
422 | Campaign configuration is incomplete |