Sign in
Contacts

Bulk-import contacts

Imports up to 1,000 contacts in one request. Each phoneNumber is normalized to E.164; rows that fail normalization are skipped (invalid_phone) rather than failing the whole request. Duplicate phone numbers within the batch are deduplicated, keeping the last occurrence (earlier ones are reported as duplicate_in_file). Existing contacts are updated by matching phone number; new ones are created. Rate-limited per owner — returns 429 when the limit is exceeded.

post/numbers/contacts/import

Request body

Example request

{
  "items": [
    {
      "name": "Jane Doe",
      "phoneNumber": "+1 555-123-0001"
    }
  ]
}

Response

Import processed

Changes