POST
/
v1
/
leads
/
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>'
{
  "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

Response

200
application/json
Successful Response

The response is of type object.