Import Leads (CSV) - Qall Voice AI Docs

Bulk-imports leads from a CSV file. Duplicate phone numbers within the campaign are automatically skipped.

Path Parameters

Parameter	Type	Description
`id`	integer	The campaign ID.

Request

Send a multipart/form-data request with the CSV file in the file field.

curl -X POST https://api.qall.io/api/campaigns/1/leads/import \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "[email protected]"

CSV Format

The CSV file should include a header row. The only required column is phone_number.

Column	Required	Description
`phone_number`	Yes	Phone number in E.164 format.
`name`	No	Lead display name.
`lead_timezone`	No	IANA timezone for per-lead window enforcement.

Additional columns are stored in the lead’s custom_vars field automatically. Example CSV:

phone_number,name,lead_timezone,company
+15551234567,John Doe,America/New_York,Acme Corp
+15559876543,Jane Smith,America/Chicago,Widget Inc
+15550001111,Bob Johnson,,StartupCo

Response

{
  "success": true,
  "data": {
    "accepted": 2,
    "rejected": 0,
    "duplicates": 1,
    "errors": []
  }
}

Field	Description
`accepted`	Number of leads successfully imported.
`rejected`	Number of rows rejected due to invalid data.
`duplicates`	Number of rows skipped because the phone number already exists in this campaign.
`errors`	Array of human-readable error strings for rejected rows.