Bulk import contacts

Creates contacts in bulk from a list of entries shaped like a create request, returning per-entry results with created, updated, skipped, and error counts.

POST
/v1/contacts/bulk-import

Creates contacts in bulk from a list of entries shaped like a create request, returning per-entry results with created, updated, skipped, and error counts. An entry whose identities match an existing contact is skipped, or updates it with onConflict: "update".

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

contacts*array<>
onConflict?|null

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/contacts/bulk-import" \  -H "Content-Type: application/json" \  -d '{    "contacts": [      {        "name": "string"      }    ]  }'
{  "total": 0,  "created": 0,  "updated": 0,  "skipped": 0,  "errors": 0,  "results": [    {      "index": 0,      "status": "created",      "contactId": "string",      "error": "string"    }  ]}

Related documentation