Skip to main content
POST
/
v1
/
leads
/
bulk-upload
Create Leads By Bulk Upload
curl --request POST \
  --url https://api.eqho.ai/v1/leads/bulk-upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-KEY: <api-key>' \
  --form 'lead_list_name=<string>' \
  --form 'campaign=<string>' \
  --form file=@example-file
{
  "summary": {
    "total_records": 123,
    "successful_records": 123,
    "error_records": 123
  },
  "errors": [
    {
      "line_number": 123,
      "errors": [
        "<string>"
      ]
    }
  ]
}
If you have large numbers of leads to upload, you can use the bulk upload endpoint. This endpoint will process the leads in chunks and return the results of the processing. Your CSV file should have the following columns:
  • phone - Required. Phone number in E.164 format. Must be US numbers. If duplicate numbers are found, the row will be skipped. Example: +18015551831
  • email - Required. Email address. Example: [email protected]
  • first_name - Required. First name. Example: Jane
  • last_name - Required. Last name. Example: Smith
  • timezone - Required. Timezone. Example: US/Mountain

Authorizations

​
X-API-KEY
string
header
required

Body

multipart/form-data
​
file
file
required
​
lead_list_name
string | null
​
campaign
string | null

Response

Successful Response

​
summary
object
required
​
errors
BulkUploadError · object[]
required