Create contact
Contacts
Create contact
Adds and stores a new contact in the user’s address book; prevents duplicate phones.
POST
Create contact
Authorizations
Path Parameters
Owner user token.
Body
application/json
Contact data to register.
POST /user/contacts/{userToken} body for partner create contact (owner resolved from path).
Country code for phone normalization and display.
ISO 3166-1 alpha-2. Example: US.
Phone number with country code (E.164).
Example: +19166020018.
Contact family name.
Example: Tru.
Contact given name(s).
Example: Hugo.
Optional label shown in the address book.
Email address.
Example: name@domain.com.
Response
200 — OK. Contact persisted.
Scenarios for this response:
| Scenario | How to reproduce | Typical code / body |
|---|---|---|
| Contact created | Valid token + body + unique phone. | { "reason": "Contact created", "code": "OK" } |
See also Full scenario matrix.