Batch Upsert Contacts
Create or update up to 1,000 contacts in a single request. Each contact is processed independently; the response includes processed, succeeded, and failed counts plus a per-contact result in request order.
Authorizations
Your Conversion API key. Found in Settings > Integrations in the dashboard. Format: sk_live_<key_id>_<secret>.
Body
An array of contact objects to upsert.
1 - 1000 elementsWhen true, restricts all operations to updates only. Contacts that are not found will be returned with a contact_not_found error in their result item.
When true, syncs upserted contacts to the connected CRM (e.g., Salesforce) if they do not already have an external CRM record.
When true, prevents overwriting existing non-empty field values for all contacts in the batch. New values are only written to fields that are currently empty or unset.
Response
Batch processed. Check the counts and each result item for individual outcomes.