Contacts

Bulk upload contacts

Forwards the request body to the Contacts Service bulk upsert for the authenticated account. The format is chosen by Content-Type: application/x-ndjson (one JSON object per line), application/json (top-level array), or text/csv (header row; tags/groups/keywords columns pipe-delimited). Returns the service's per-row ingest report; a 200 can include rejected rows — check the rejected count. Requires a user-scope token; tenant-admin tokens are rejected with 403.

post/contacts/bulk

Request

  • Base URL
    https://api.textla.com/v1
  • Auth
    HTTP bearer

Query parameters

skip_existingboolean

When true, rows whose phone already exists are left untouched and counted as duplicate

manually_added'true' | 'false'

Provenance flag applied to every row; service default applies when omitted

file_idstring

Provenance file pointer applied to every row

Request body

string binary required

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

duplicateinteger required
insertedinteger required
receivedinteger required
rejectedinteger required
updatedinteger required

Example response

{
  "$schema": "/v1/schemas/BulkUpsertReport.json"
}

Changes

No recorded changes to this operation across all 1 revision of this API.