Skip to main content
POST
Push a list's contacts into a connected CRM

Authorizations

Authorization
string
header
required

Your API token (af_…) as the Basic-auth username, with an empty password.

Path Parameters

listId
string
required

24-character hex id of the list (from GET /business/lists).

Body

application/json
crm
enum<string>
required

Which connected CRM receives the contacts: hubspot, salesforce, zoho, attio or pipedrive; an unconnected CRM answers 422 CRM_NOT_CONNECTED.

Available options:
hubspot,
salesforce,
zoho,
attio,
pipedrive
contactIds
string[]

Push only these contacts (24-character hex ids, at most 500) instead of every contact in the list: the ids are the selection, so every one of them is pushed and nothing else is. They are taken as given rather than intersected with the list, and sending them also makes the push overwrite fields on records that already exist in the CRM — pushing the whole list leaves those untouched.

Required array length: 1 - 500 elements

24-character hex id of a contact (the row id from GET /business/lists/{listId}/rows).

Response

Success

crm
enum<string>
required
Available options:
hubspot,
salesforce,
zoho,
attio,
pipedrive
listIds
string[]
required