Skip to main content
A campaign runs an agent against multiple contacts. Before you start, test the agent, publish the intended version, and configure the caller number and telephony connection.

​
Create a campaign

Open Campaigns, choose the agent and telephony configuration, and supply your contacts. You can upload a CSV or enter a manual list. Start with a small list of destinations you control to verify the flow. A CSV needs a phone_number column. Extra columns become initial context for each call:
Manual contacts require a name and a phone number with country code. The API accepts up to 100 manual contacts in one campaign request.

​
Set calling behavior

  • Concurrency limits simultaneous calls. Keep it within your provider and workspace limits.
  • Schedule sets the timezone and time windows when new calls may start.
  • Retries control how often to retry busy, unanswered, or voicemail calls and the delay between attempts.
  • Circuit breaker can pause a campaign when its recent failure rate exceeds the configured threshold.
Review these settings before starting. An enabled schedule needs at least one time slot; a disabled schedule does not restrict calls to business hours.

​
Start, pause, and review

Start the campaign when the contacts and settings are ready. Monitor progress and individual runs. Pausing stops further dispatch while calls already in progress finish. Resolve failed credentials, provider restrictions, or agent issues before resuming a paused campaign. Use the campaign results to distinguish answered calls from completed business tasks. Review transcripts and extracted data for a sample of calls before expanding the contact list. Developers can create campaigns, read progress, and retrieve campaign runs.