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 or null
list_idstring or null
List containing the leads
strategy_idstring or null
Strategy being executed
total_leadsinteger or null
Total leads in the campaign list
processed_leadsinteger or null
Leads already processed
strategies_scheduledinteger or null
Leads scheduled in this execution
unprocessed_leadsinteger or null
Remaining leads to process
executions_this_hourinteger or null

Total executions this hour (business-level)

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

Errors