Campaigns
Upload campaign entries API
Bulk-upload contacts as CSV rows or a JSON array. Rows are validated individually, with per-row failures reported alongside the accepted count.
POST
cURL
Validation happens in two stages. First a whole-upload shape check: every column must be a system field (
reference_id, mobile_number, name, email) or a field the pinned version’s start node declares — otherwise the entire upload is rejected with 422 unknown_field or missing_required_field and nothing is persisted. Then each row is validated individually: bad rows land in failures with a code (invalid_phone, invalid_field_type, missing_required_value, …) while good rows are accepted.Re-uploading a row whose earlier version failed validation replaces it in place — such rows are counted in both
accepted and corrected. Fetch the expected header with the CSV template endpoint. Uploads are capped at 32 MB and 150,000 rows.Authorizations
Body
The body is of type string.
Example:
"mobile_number,name,city\n+919876543210,Asha,Pune\n+919876543211,Ravi,Mumbai\n"
Response
Per-row upload result