Bulk import contacts (JSON)

Add or update up to 100 contacts in one background job - ideal for CRM sync batches that do not need a CSV file.

For lists larger than 100 contacts, use the CSV import endpoint.

Each row is matched by email (create or update), same as Create or update contact. Returns 202 Accepted with a bulk_job object. Poll Show bulk job status (GET /bulk-jobs) until status is done or failed.

ConstraintValue
Max rows100
Concurrent async jobs per account10
Bulk rate limit5 requests/min per API token

409 if the account already has 10 async jobs in new/running. 423 if the account is locked for processing or has reached its contact limit.

Body Params
contacts
array of objects
required
length between 1 and 100
contacts*
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json