/{tenantId}/api/v1/sendDirectSendMessage/{whatsappNumber}

Send a direct message to one WhatsApp recipient. POST /{tenantId}/api/v1/sendDirectSendMessage/{whatsappNumber}.

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
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Recipient WhatsApp number used as the id value for contact resolution. This path value overrides id supplied in the request body.

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
Body Params

Data model with fields: text, id, contactId, bsuid, localMessageId....

string | null
string | null
string | null
string | null
string | null
media
object

Data model with fields: data, caption, mimeType, serverFile, filePath....

string | null
string | null
string | null
string | null
string | null
boolean
string | null
string | null
string | null
interactive
object

Data model with fields: type, header, body, footer, action.

customParams
array of objects | null
customParams
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json-patch+json

Generated from available request content types

Allowed:
Responses

400

Invalid or missing request body, invalid direct-send fields or localMessageId, offline mode, direct-send feature unavailable, or send failure. The response body depends on the failure: offline mode can return a string; validation and send failures return an object with result=false and info.

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
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json