Skip to main content
POST
Create Leads By Bulk Upload
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

Your API key for authentication.

x-org-id
string
header
required

Org impersonation via x-org-id. Superadmins may impersonate any org; admins may impersonate their direct sub-organizations. Enter the target organization ID to act as that org.

Body

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

Response

Successful Response

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