Skip to main content
POST
Batch import contacts

Authorizations

Authorization
string
header
required

API token for authentication

Body

application/json
workspace_id
string
required

The ID of the workspace

Example:

"ws_1234567890"

contacts
object[]
required

Array of contacts to import (create or update)

Minimum array length: 1
Example:
subscribe_to_lists
string[]

Optional array of list IDs to subscribe all contacts to

Example:

Response

Batch import completed (may include partial failures)

operations
object[]

Array of operation results, one for each contact in the request

error
string | null

Global error message if the entire operation failed

Example:

null