Skip to main content
POST
Import contacts

Authorizations

Authorization
string
header
required

Organization-scoped Auth0 user access token issued to an approved first-party client or exchanged by a trusted OBO resource server.

Body

application/json

Bounded atomic Contact import with an explicit tenant-local identity deduplication policy.

contacts
object[]
required
Required array length: 1 - 500 elements
dedupe
enum<string>
default:skip
Available options:
create,
skip

Response

OK

Per-row outcomes and aggregate counts for one Contact import.

created
integer
required
Required range: 0 <= x <= 500
linked
integer
required
Required range: 0 <= x <= 500
results
object[]
required
Maximum array length: 500
skipped
integer
required
Required range: 0 <= x <= 500