Skip to main content

Create Campaign

Create a new campaign for the authenticated user. This endpoint accepts multipart/form-data.

Request Body (multipart/form-data)

string
required
Campaign name
integer
required
ID of the phone number to use
string
required
ID of the agent to use for calls
file
required
CSV file with recipient phone numbers. Format: one phone number per line.
boolean
required
Whether to send the campaign immediately (true) or schedule it (false)
string
Date in YYYY-MM-DD format (required if send_immediately is false)
string
Time in HH:MM:SS format (required if send_immediately is false)

CSV File Format

The recipients file should be a CSV with phone numbers. Example:

Scheduled Campaign Example

To schedule a campaign for later:

Response

object
Response status information
integer
HTTP status code (201)
string
Status message
object
Created campaign object

Error Responses

object
Unauthorized - Invalid or missing authentication
object
Phone number or agent not found
object
Validation error - Invalid request body or file format
object
Bad gateway - ElevenLabs API error