Create a contact

post

https://api.sintalk.com.br/v3/contacts

Creates a contact, or updates the one already holding the same phone number. The submitted phone is normalized to canonical E.164 before matching, so every accepted format resolves to the same contact. Omitted fields keep their stored value; attributes, when present, replaces the whole map.

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200A contact with this phone number already existed and was updated.

201No contact held this phone number and one now does. A contact deleted earlier under the same number is restored with its original id.

400The request was rejected before it was applied — either a field failed validation (validation_failed, with error.fields naming each one), or the request could not be read at all (bad_request: malformed JSON, an unknown field, a missing parameter, or an unparseable path or query value).

401No credential was presented, or the one presented was rejected.

403The credential is valid but is not allowed to call this operation.

422The body parsed and every field is individually valid, but the request cannot be applied as asked. Retrying it unchanged will fail again.

429Rate limit exceeded

defaultAn unexpected error. Safe to retry with backoff; use an idempotency key where the operation accepts one.