Upload a CSV Call List
Upload call-list files with the required size and type constraints.
What this covers
Upload a campaign call-list CSV to create scheduled outbound calls.
When to use this
Use this right after campaign creation or when adding new call batches.
Before you start
- You can edit the target campaign.
- The campaign is not in a final state.
- Your file is CSV/text and no larger than 5 MB.
Steps
- Open /campaigns , open your campaign, and select Add Calls / CSV upload.
- Prepare a header row plus data rows using the minimal template: `country_code,phone_number,additional_info`.
- Use example rows such as `+1,5551234567,[{"key":"first_name","type":"string","value":"Alex"}]` and `, +15557654321,` (country code optional when number is E.164 in phone_number).
- Choose your CSV file and submit.
- Review the result and fix any row-level errors if shown.
Important fields and options
country_code
Optional. Digits with or without leading `+` (for example `+1` or `1`).
phone_number
Required. Digits-only local number (when country_code provided) or E.164-style with leading `+` when country_code is empty.
additional_info
Optional JSON array of objects with keys `key`, `type`, `value`; `type` must be `string` or `link`, and `value` must be string.
Validation and common errors
- Invalid MIME/type can show: "Please upload a valid CSV file."
- Unauthorized edit attempts can show: "You don't have permission to edit this campaign."
- Final-state uploads can show: "Campaign cannot be in a final state."
- Success confirms: "CSV file uploaded successfully."
Notes
- Beginner-friendly file types: use `.csv` files (comma-separated text). Other text/csv MIME variants can work, but plain `.csv` is the safest option.
- CSV header names are not validated by import logic, but keeping the template header/order prevents column-mapping mistakes.