Request a campaign data export
Queues an asynchronous export of the campaign’s call history or survey responses as CSV or XLSX and returns immediately with a job handle — nothing is generated during the request. Poll the job with the export-status call.
When the job completes, fetch the file through the export-download call, which mints a pre-signed link; the same link is also emailed to the requester. Optional filters narrow the export by contact, agent or date range — omit them to export everything for the campaign.
The call is not idempotent: every request enqueues a new job, so a retry after a timeout creates a second export and a second link. There is no deduplication window or idempotency key.
Authorizations
HTTP Basic Authentication. Use your API Access Key ID as the username and your API Access Key Secret as the password. Generate keys in the CloudTalk Dashboard under Account -> Settings -> API Keys (https://dashboard.cloudtalk.io/menu/account/settings/API-keys).
Path Parameters
Dialer campaign ID.
^[1-9][0-9]*$Body
Body of the export enqueue call.
What to export. call_history exports the campaign's dial log; survey_responses exports answers collected by the campaign's survey.
call_history, survey_responses "call_history"
Serialisation format of the generated file.
csv, xlsx "csv"
Optional narrowing filters. Omitting the whole object exports everything for the campaign.
Response
The export job was accepted and queued.
Related topics
CloudTalk API Response Envelope Formats and SchemaGet an export job's statusGet a download link for a completed export