# Contacts API

Canonical: https://tyxter.com/docs/api-reference/contacts
Section: API reference

Contacts, consent, bulk import, data export, and erasure endpoints.

# Contacts API

Public contact endpoints cover opt-in, opt-out, list, bulk import, data export, and erasure.

`POST /v1/contacts/bulk-import` accepts `{ rows, source? }`, with 1–1,000 rows. Each row requires
an E.164 `phone` and may include `metadata`; `source` defaults to `api`. Repeated phones in one
payload are collapsed. The response returns every contact from the deduplicated input in `data`,
plus `imported` for newly opted-in contacts and `skipped` for contacts already opted in. Reuse the
same `Idempotency-Key` only when retrying an identical import.