Add customer contact

POST 
/v1/contacts

Creates a contact. The phone is normalized to E.164 and email is lowercased before storage; those normalized values are also indexed in contact_identities so a later inbound message on the same number or address resolves to this contact instead of creating a duplicate. An unparseable phone returns 400. If the phone or email already belongs to another contact in the account, the request is rejected with 409.

Permissions - contacts.write. API keys - manage.

Request

Responses

201

The new contact

400

BadRequest

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

401

Unauthorized

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

404

The specified resource was not found

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

409

The request conflicts with the current state (for example, a name already in use)

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789

500

Internal Server Error

Response Headers

X-Request-Id
Unique identifier for the API request, useful for debugging and tracking.
Example: abc123xyz789