Add a contact to the list by phone number

post

https://api.sintalk.com.br/v3/contact-lists/{list_id}/contacts

Use this when you hold a phone number rather than a contact id. The number is normalized to canonical E.164 and matched against your contacts: the contact it finds is updated, and when there is none a contact is created — either way it ends up in this list, in one call. Omitted fields keep their stored value; attributes, when present, replaces the whole map. Repeating the call for the same number does not add a second membership.

To add a contact you already have the id of, without touching its fields, use PUT /contact-lists/{list_id}/contacts/{contact_id} instead.

Responses

200A contact already held this phone number; it was updated and is now in the list.

201No contact held this phone number and one now does, added to the list. 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.

404No resource with that id exists in your account. An id belonging to another account is reported the same way as one that never existed.

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.