Skip to main content

Call Campaigns

Create and manage outbound call campaigns with IVR flows, automatic retries, scheduling, and detailed reporting.

Base URL

https://<api_key>:<api_token><subdomain>/v2/accounts/<account_sid>/campaigns

Regional Endpoints

RegionSubdomain
Singapore@api.exotel.com
Mumbai@api.in.exotel.com

Capabilities

  • Bulk outbound calls — Up to 5,000 phone numbers per campaign
  • IVR flows — Connect campaigns to interactive voice menus
  • Auto-retries — Retry failed/busy/no-answer calls up to 3 times
  • Scheduling — Schedule campaigns for future execution
  • Real-time webhooks — Per-call and per-campaign status callbacks
  • Campaign controls — Pause, resume, complete, and archive campaigns

Rate Limits

LimitValue
Default call capacity60 calls/minute
Max numbers per campaign5,000
Max retries3
Campaign duration30 days (default)
note

Contact Exotel support to increase your call capacity beyond 60 calls/minute.

Campaign Types

TypeDescription
staticFixed list of numbers provided at creation
dynamicNumbers sourced from a list SID (can be updated)

Campaign Status Flow

Created → InProgress → Completed
→ Paused → Resumed → Completed
→ Completed (force, marks remaining as failed)
Completed → Archived

Endpoints

EndpointMethodDescription
Create CampaignPOSTCreate a new call campaign
Manage CampaignGET/PUT/DELETEGet details, pause/resume, delete
Call DetailsGETGet individual call records
WebhooksWebhook reference