Skip to main content
POST
Import contacts from a CSV file

Authorizations

Authorization
string
header
required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, an opaque member token, or a verified One Auth identity access token for a non-impersonated rep or shopper. The credential alone identifies the member and company.

Headers

Idempotency-Key
string

Names this upload so it can be resent safely after a lost response, 1 to 255 characters. A resend returns the first import, however late. Send a new key for a new import of the same file. Without it every upload is a new import.

Required string length: 1 - 255

Body

multipart/form-data
file
file
required

The CSV file, UTF-8 encoded.

Response

The accepted import.

One contact import.

status
integer
required
data
object
required

A durable contact import and its progress.

meta
object
required

Envelope metadata present on every response.