Skip to Content
CallMitraDocs
API referenceCampaigns

Start a campaign

Starts dialing. Calls are placed only inside the dial window and up to the daily limit. The campaign must have an agent whose prompt the leads can fill and a number that can place calls; otherwise nothing changes and the error says what to fix.

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

Starts dialing. Calls are placed only inside the dial window and up to the daily limit. The campaign must have an agent whose prompt the leads can fill and a number that can place calls; otherwise nothing changes and the error says what to fix.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Path Parameters

campaign_id*string

Campaign ID.

Formatuuid

Response Body

OK

application/json
  1. response

The campaign is running.

leadCount?|

Active leads on the campaign.

message?|

Human-readable confirmation.

processedCount?|

Same as leadCount, kept for older clients.

success?|

Always true.

warnings?array<string>|

Things that may hurt answer rates, for example a caller ID outside the usual series.

[key: string]?any
Example Request
curl -X POST 'https://api.callmitra.ai/api/v1/campaigns/497f6eca-6276-4993-bfeb-53cbbbba6f08/start'
Example Response
{  "leadCount": 120,  "message": "Campaign started — dialing will proceed automatically on schedule",  "processedCount": 120,  "success": true,  "warnings": []}