CSV Format

This page covers the requirements for CSV files uploaded to bulk campaigns.

Required Column

Every CSV must include a phone_number column:

phone_number
+15551234567
+15559876543
+15551112222

Phone Number Format

Phone numbers must be in E.164 international format — a + followed by the country code and number, with no spaces or dashes.

Format	Valid	Example
E.164	✅	+15551234567
Local (no country code)	❌	5551234567
Formatted	❌	(555) 123-4567

Common country codes:

• US / Canada: +1
• UK: +44
• Australia: +61

Adding Variables

Include additional columns to pass data to your assistant as call variables. Column names become the variable names:

phone_number,firstName,company,appointmentDate
+15551234567,John,Acme Corp,January 15th
+15559876543,Sarah,Tech Inc,January 16th
+15551112222,Mike,Global Co,January 17th

During the campaign creation wizard you'll map these columns to your assistant's configured variables.

Validation Rules

Rule	Requirement
Column headers	First row must be headers
Phone column	phone_number column is required
Phone format	All numbers must be valid E.164
File size	Maximum 10 MB
Row limit	Maximum 10,000 contacts per file
Encoding	UTF-8

Example Files

Simple List

phone_number
+15551234567
+15559876543
+15551112222

With Variables

phone_number,firstName,lastName,company
+15551234567,John,Smith,Acme Corp
+15559876543,Sarah,Jones,Tech Inc
+15551112222,Mike,Wilson,Global Co

Appointment Reminders

phone_number,patientName,appointmentDate,appointmentTime
+15551234567,John Smith,January 15,2:00 PM
+15559876543,Sarah Jones,January 15,3:30 PM

Common Issues

"Invalid phone number on row X"

• Check the country code is included
• Remove spaces, dashes, and brackets
• Ensure the number is valid

"Missing phone_number column"

• Make sure the first row contains column headers
• Check the header is spelled exactly phone_number

"File too large"

• Split into multiple CSV files under 10 MB each

Next Steps

• Bulk Campaigns — Create your campaign
• Campaign Monitor — Track progress