API reference
Imports
API reference descriptions are provided in English to preserve the exact published contract.
List bulk imports
GET /v1/accounts/{AC}/imports
getV1AccountsByAcImportsPaginated200
Required scope: `operations:read`.
Parameters
Parameters| Name | Type | Required | Description |
|---|
limit | query · integer (1–100) | | |
cursor | query · string (max 2048 chars) | | |
AC | path · string (AC… SID) | yes | Account SID |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.
Upload a bulk import
POST /v1/accounts/{AC}/imports
postV1AccountsByAcImportsIdempotency-Key required202
Required scope: `contacts:write`.
Parameters
Parameters| Name | Type | Required | Description |
|---|
AC | path · string (AC… SID) | yes | Account SID |
Request body (4 fields)
Request body| Name | Type | Required | Description |
|---|
defaultCountry | string (pattern ^[A-Z]{2}$) | | |
file | file (binary) | yes | |
format | "CSV" | "JSON" | "XLSX" | | |
kind | "CONTACTS" | "CONSENTS" | "SUPPRESSIONS" | "AUDIENCE" | yes | |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.
Fetch an import
GET /v1/accounts/{AC}/imports/{IM}
getV1AccountsByAcImportsByIm200
Required scope: `operations:read`.
Parameters
Parameters| Name | Type | Required | Description |
|---|
AC | path · string (AC… SID) | yes | |
IM | path · string (IM… SID) | yes | |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.
List rejected import rows with structured reasons
GET /v1/accounts/{AC}/imports/{IM}/rejections
getV1AccountsByAcImportsByImRejectionsPaginated200
Required scope: `operations:read`.
Parameters
Parameters| Name | Type | Required | Description |
|---|
reason | query · string (max 200 chars) | | |
limit | query · integer (1–100) | | |
cursor | query · string (max 2048 chars) | | |
AC | path · string (AC… SID) | yes | |
IM | path · string (IM… SID) | yes | |
Errors: 400, 401, 403, 404, 409, 422, 429, 500, 503 — see errors.