Batch size: 1–100 contacts. The current handler denies callers with the TRIAL role, including callers that also have another listed role; a subscription trial and the TRIAL role are not interchangeable. This denial can return HTTP 401 with a plain-text body. Do not assume a JSON error or retry by widening token scopes.

Update contacts. PUT /api/ext/v3/contacts.

Permissions

For API access tokens and OIDC tokens, satisfy at least one of: api, wati_integration:write, contactsv3:write. API access tokens may satisfy a listed scope through the configured scope hierarchy; OIDC tokens are checked against their scope claims. Legacy JWT authentication does not use this scope check. Authentication, role, tenant, and applicable feature or plan checks still apply. For HTTP 403, check the credential type, applicable scopes, roles, and workspace access; 403 does not always mean a missing scope. Authentication/authorization failures do not guarantee a JSON response body.