Assign User

post

https://live-mt-server.wati.io/{tenantId}/api/v1/assignOperator

Assign User. POST /{tenantId}/api/v1/assignOperator.

Permissions

For API access tokens and OIDC tokens, satisfy at least one of: api, wati_integration:write, conversations: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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tenantId

string

required

Your WATI workspace (tenant) ID. This required path segment identifies the WATI account for legacy v1 and v2 API requests.

Query Params

string

User Email (if Email is not specified, the chat will be assigned to the Bot)

whatsappNumber

string

WhatsApp Number with country code. Example, 85264318721. Optional when target is provided.

target

string

Polymorphic recipient identifier. Accepts a phone number, ContactId, or BSUID. When provided, takes precedence over whatsappNumber. BSUID resolution requires the wati_contact_bsuid_support Statsig gate to be enabled for the tenant.

channelPhoneNumber

string

Channel phone number with country code. Example, 85264318722

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

403

Authorization failed. Check the Permissions section for the credential-specific scope rules, and check roles and workspace access. The response may have no body; do not require a JSON error envelope.

Language

Credentials

Bearer

Loading…

Response

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

text/plain

application/json

text/json

200OK