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.
Plan availability
Commercial plan policy: one contact per request is included in Growth, Pro and Business; 2–100 contacts per request are Business-only. The current TRIAL-role denial remains separate from subscription plan eligibility. Account-specific runtime enforcement may differ; this documentation correction does not change account access. Authentication, roles, scopes and workspace/channel requirements still apply. See Endpoint availability by plan.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
429Too many requests. Either the rate limit has been exceeded or usage limits have been reached.

