Skip to main content
POST
Enqueue a bulk contact import

Authorizations

Authorization
string
header
required

Dashboard JWT token from Clerk

Body

application/json
rows
object[]
required

The rows to import, each a map of already-mapped field keys to string values.

Required array length: 1 - 1000000 elements
file_name
string

Original upload file name, retained for auditing.

Maximum string length: 255
merge_strategy
enum<string>
default:skip

How to handle rows that match an existing contact. skip leaves matches untouched; merge updates them.

Available options:
skip,
merge

Response

202 - application/json

Import accepted and queued; poll the job id for progress.

data
object
meta
object