Create, schedule, and monitor Retell batch calls in bulk to run outbound campaigns, send updates, or contact large recipient lists from a single workflow.
Batch calls enable you to efficiently manage multiple calls by organizing them into groups. You can create, schedule, and monitor calls in bulk, streamlining communication workflows. This feature is particularly useful for campaigns, updates, or any situation requiring multiple recipients to be contacted.
Navigate to the Batch Call tab in the Retell AI workspace and click the “Create Batch Call” button located in the top-right corner.
Create a batch call
2
Enter call name and phone number
Provide a unique name for the batch call to differentiate it from others
Select the “From Number” from the dropdown menu
Ensure the number is bound to agents to enable batch calls
3
Upload CSV
Prepare your recipient list in CSV format with a header row including a “phone number” column
Use the provided CSV template by clicking “Download the template,” or upload your custom file
Edit batch call
For dynamic variables, add additional columns in the CSV with custom data for each recipient (e.g., a column header first_name can be referenced as {{first_name}})
If the number to call is not in e.164 format, you can choose to ignore e.164 validation by adding a column to the CSV named ignore e164 validation with value true. This only applies when you are using custom telephony and does not apply when you are using Retell Telephony.
The CSV also supports the following optional columns:
override agent id: Override the agent used for this particular call.
override agent version: Override the agent version for this particular call.
metadata: A JSON string to store arbitrary data with the call (e.g., {"customer_id":"cust_123"}).
custom_sip_headers: A JSON string of custom SIP headers, keys must start with X- (e.g., {"X-Custom-Header":"value"}).
Any other columns are treated as dynamic variables injected into your Response Engine prompt and tool descriptions.
4
Configure the time window
Open the configuration modal to define the batch call time windows
Batch Call Time Window Configuration
5
Create now or schedule
Choose between “Send Now” to start the calls immediately or “Schedule” for a future time
Click “Save as Draft” to revisit later or “Send” to initiate or schedule the calls
