Start a campaign
Validates the campaign (lead lists attached, leads present, account
quota covers a call’s dial-time reserve), creates a campaign run, and
marks the campaign running so workers begin queuing calls. If the
campaign has a future schedule_time, validation runs the same way
but the campaign is moved to scheduled instead, with no run
created yet. It starts automatically at the scheduled time.
Send an Idempotency-Key header to make retries safe: a request
with a key that already produced a run for this campaign returns
the existing run with 200 instead of creating a second one. The
key represents one logical start operation, not one HTTP request.
Authorizations
Use Authorization: Bearer tc_live_xxxxx
Headers
Optional client-supplied idempotency key. When present, the gateway
caches the response for 24 hours and returns the same response on
retried requests with the same key (account-scoped). Safe for
retries on network blips. Format: 8-255 ASCII characters from
[A-Za-z0-9_-].
8 - 255^[A-Za-z0-9_-]+$"a1b2c3d4-e5f6-7890-abcd-ef0123456789"
Path Parameters
Campaign UUID
Response
Idempotent replay. A run already exists for this Idempotency-Key