Campaigns

Execute Campaign

Execute a campaign to process leads from the associated list. Leads are scheduled with time-spreading to avoid carrier spam flagging. Rate limited per business (default: 100 leads/hour).

Authentication

X-API-Keystring
Your API key from [Dashboard → Settings → API Keys](https://dashboard.bookedin.ai/settings)

Request

This endpoint expects an object.
campaign_idstringRequired
Campaign ID to execute
lead_countintegerOptional>=1
Number of leads to process in this batch. If not specified, uses remaining hourly quota.

Response

Campaign execution queued
campaign_idstring
list_idstring
List containing the leads
strategy_idstring
Strategy being executed
total_leadsinteger
Total leads in the campaign list
processed_leadsinteger
Leads already processed
strategies_scheduledinteger
Leads scheduled in this execution
unprocessed_leadsinteger
Remaining leads to process
executions_this_hourinteger

Total executions this hour (business-level)

remaining_this_hourinteger
Remaining executions available this hour
reset_timedouble
Unix timestamp when rate limit resets
can_continueboolean
Whether campaign has more leads to process
messagestring

Errors

400
Bad Request Error
402
Payment Required Error
404
Not Found Error
429
Too Many Requests Error