Skip to main content
POST
/
campaigns
/
{campaign_id}
/
launch
curl -X POST https://api.thinnest.ai/campaigns/{campaign_id}/launch \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "camp_a1b2c3d4",
  "status": "running",
  "started_at": "2026-03-07T14:30:00Z",
  "total_contacts": 150,
  "message": "Campaign launched successfully"
}'

{
  "id": "camp_a1b2c3d4",
  "status": "running",
  "started_at": "2026-03-07T14:30:00Z",
  "total_contacts": 150,
  "message": "Campaign launched successfully"
}

curl -X POST https://api.thinnest.ai/campaigns/{campaign_id}/launch \
  -H "Authorization: Bearer $THINNESTAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "id": "camp_a1b2c3d4",
  "status": "running",
  "started_at": "2026-03-07T14:30:00Z",
  "total_contacts": 150,
  "message": "Campaign launched successfully"
}'

​
Path Parameters

​
campaign_id
string
required
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

CodeDescription
401Missing or invalid authentication
402Insufficient balance
404Campaign not found
409Campaign is not in draft status
422Campaign configuration is incomplete

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
campaign_id
integer
required

Query Parameters

​
force_rerun
boolean
default:false

Response

Successful Response