Upload Campaign Contact List
Uploads a contact list for a campaign. Accepts a CSV file and campaign configuration as form data.
📋 Quick Start
- Prepare your CSV - Download template from your campaigns tab
- Configure your agent - Set up prompts and custom variables
- Upload & configure - Submit CSV with campaign settings
- Start calling - Use the returned
list_idto start your campaign
📁 CSV File Requirements
Example CSV Structure
⚙️ Configuration Parameters
Required Fields
Optional Settings
CSV File Format
Download the exact CSV template from your campaigns tab to get the correct format according to your specific agent configuration. The required columns vary based on your agent’s custom variables.🔗 Variable Mapping
Connect your CSV columns to agent variables so your AI can use the contact data during calls.How It Works
Map CSV column names to your agent’s custom variables:Using Variables
Reference mapped variables in your agent prompt with@{{variable_name}}:
@{{callee_name}}→ “John Doe”@{{company_name}}→ “XYZ Corp”
⏰ Call Configuration
Control when and how your campaign calls are made:✅ What Happens Next?
Success Response
You’ll receive alist_id - save this! You need it to start your campaign.
Next Steps
- Save the
list_idfrom the response - Start your campaign using the
list_id - Monitor progress and view results
Error Handling
If upload fails, check:- ✅ CSV format and required columns
- ✅ Valid phone number format with country codes
- ✅ Agent ID exists and is active
- ✅ API key permissions
remove_invalid_rows=true to automatically skip problematic contacts instead of failing the entire upload.Headers
(Required) Your Revenueable AI API key.
"7251cb4b-3373-43a4-844c-b27a1d45e0c9"
Body
(Required) JSON string mapping variable names to columns
(Required) Unique identifier for the agent
"830f767a-397e-4b39-82ff-235cd344e2f9"
(Required) JSON string of call configuration
(Required) Country code for the campaign
"US"
(Required) Start time for the campaign (DD/MM/YYYY, HH:MM format)
"18/10/2025, 09:00"
(Required) End time for the campaign (DD/MM/YYYY, HH:MM format)
"18/10/2025, 21:05"
(Required) Name of the campaign.
"Q1 Sales Campaign"
(Required) CSV file containing the contact list.
Response
Contact list uploaded and campaign saved successfully.
"Contacts imported successfully!"
ID of the created campaign list
"123e4567-e89b-12d3-a456-426614174000"
Array of custom variables for each contact
Total number of rows in uploaded CSV
100
Number of successfully processed rows
98
Number of rows that failed validation
2
