Imports

API reference descriptions are provided in English to preserve the exact published contract.

GETList bulk importsimports.list
POSTUpload a bulk importimports.create
GETFetch an importimports.retrieve
GETList rejected import rows with structured reasonsimports.rejections.list

List bulk imports

GET/v1/accounts/{AC}/imports

imports.listSDK operation getV1AccountsByAcImports

Required scope: operations:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/imports

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/imports" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Upload a bulk import

POST/v1/accounts/{AC}/imports

imports.createSDK operation postV1AccountsByAcImports

Required scope: contacts:write.Idempotency-Key required

Request body

filefile (binary)Required
kindenumRequired
CONTACTSCONSENTSSUPPRESSIONSAUDIENCE
defaultCountrystring (pattern ^[A-Z]{2}$)
formatenum
CSVJSONXLSX

POST /v1/accounts/{AC}/imports

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/imports" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "file": "string",
  "kind": "CONTACTS"
}'

Responses

Fetch an import

GET/v1/accounts/{AC}/imports/{IM}

imports.retrieveSDK operation getV1AccountsByAcImportsByIm

Required scope: operations:read.

Parameters

IMstring (IM… SID)Required

GET /v1/accounts/{AC}/imports/{IM}

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/imports/IM..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

List rejected import rows with structured reasons

GET/v1/accounts/{AC}/imports/{IM}/rejections

imports.rejections.listSDK operation getV1AccountsByAcImportsByImRejections

Required scope: operations:read.Paginated

Parameters

IMstring (IM… SID)Required
reasonstring (max 200 chars)query
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/imports/{IM}/rejections

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/imports/IM.../rejections" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses