Summary

If you're using Wati's Multiple WhatsApp Numbers feature, this guide explains how to use Wati's API across different connected numbers.

Instructions

If your Wati account has multiple WhatsApp numbers connected, you can use these numbers to send and receive messages through the API.

To ensure an API request uses the correct WhatsApp number, you may need to include an additional key in the request payload or URL. The required key and how you pass it depend on the API endpoint you use.

This guide lists the Wati APIs that currently support multiple WhatsApp numbers and explains how to specify the WhatsApp number for each API request.

Before You Begin

Authentication: Create a scoped API token at Connector > API > Create API Token.

Host: https://live-mt-server.wati.io

v1 paths include /{tenantId}/ after the host: https://live-mt-server.wati.io/{tenantId}/api/v1/...
v3 paths do NOT include /{tenantId}/: https://live-mt-server.wati.io/api/ext/v3/...

Phone number format: Use digits with country code, no "+" symbol. Example: 85264318722.

Note:

v3 is recommended for all new integrations. v1 is legacy but still supported.

A 200 response means your request was accepted, not that the message was delivered. Delivery is confirmed by the Delivered, Read, or Replied webhooks. Failures are reported by the Template Message Failed webhook.

v1 API Endpoints

1. Send Template Message

Endpoint: POST /{tenantId}/api/v1/sendTemplateMessage

Parameter	Location	Notes
`channel_number`	Body	The number to send from
`target`	Body	Phone number, ContactId, or BSUID of the recipient. When provided, `whatsappNumber` is optional.

2. Send Template Messages (bulk)

Endpoint: POST /{tenantId}/api/v1/sendTemplateMessages

Parameter	Location	Notes
`channel_number`	Body	The number to send from

3. Send Template Message via CSV

Endpoint: POST /{tenantId}/api/v1/sendTemplateMessageCSV

Parameter	Location	Notes
`channelNumber`	Query	The number to send from

4. Update Chat Status

Endpoint: POST /{tenantId}/api/v1/updateChatStatus

Parameter	Location	Notes
`channelPhoneNumber`	Body	The number whose chat status you want to update

5. Get Messages by WhatsApp Number

Endpoint: GET /{tenantId}/api/v1/getMessages/{whatsappNumber}

Parameter	Location	Notes
`tenantId`	Path	Your Wati tenant ID
`whatsappNumber`	Path	The recipient's WhatsApp number
`channelPhoneNumber`	Query	The connected number to fetch messages from

6. Endpoints that accept `channelPhoneNumber` as a query parameter

The following endpoints use channelPhoneNumber as a query parameter to specify which connected number to use. For sendSessionMessage, messageText is also a query parameter.

Endpoint	Method
`/{tenantId}/api/v1/sendSessionMessage/{whatsappNumber}`	POST
`/{tenantId}/api/v1/sendSessionFile/{whatsappNumber}`	POST
`/{tenantId}/api/v1/sendSessionFileViaUrl/{whatsappNumber}`	POST
`/{tenantId}/api/v1/sendInteractiveButtonsMessage/{whatsappNumber}`	POST
`/{tenantId}/api/v1/sendInteractiveListMessage/{whatsappNumber}`	POST
`/{tenantId}/api/v1/assignOperator/{whatsappNumber}`	POST

For all endpoints above: whatsappNumber (path) is optional when target is provided.

7. APIs that work without specifying a number

Contact data is shared across all connected numbers, so these endpoints do not require a channel number:

API	Endpoint
Add Contact	`POST /{tenantId}/api/v1/addContact/{whatsappNumber}`
Update Contact Attributes	`POST /{tenantId}/api/v1/updateContactAttributes/{whatsappNumber}`
Update Contact Attributes for Multiple Contacts	`POST /{tenantId}/api/v1/updateContactAttributesForMultiContacts` (Business plan only)
Get Contact List	`GET /{tenantId}/api/v1/getContacts`

v3 API — Recommended for New Integrations

v3 is the recommended version for all new integrations. It does not use /{tenantId}/ in the path.

Token scopes — create at Connector > API > Create API Token:

contactsv3:* — contact operations
conversationsv3:* — conversation operations
messagetemplatev3:write — sending templates

List connected numbers

Endpoint: GET https://live-mt-server.wati.io/api/ext/v3/channels

Returns all WhatsApp numbers connected to your Wati account.

Send Template Message (v3)

Use the channel field in the request body to specify which number to send from.

The target field accepts:

Phone number — 85264318722
ContactId
BSUID
Channel-scoped format — Channel:85264318722

API Support for Multiple WhatsApp Numbers

API	Multiple Numbers Supported
Send template message	Yes
Send template messages	Yes
Send template message via CSV	Yes
Send session message	Yes
Send session file	Yes
Send session file via URL	Yes
Send interactive buttons message	Yes
Send interactive list message	Yes
Assign operator	Yes
Update chat status	Yes
Get messages by WhatsApp number	Yes
Get contacts list	Yes
Add contact	Yes
Update contact attributes	Yes
Update contact attributes for multiple contacts	Yes (Business plan only)

For more information about Wati APIs, refer to our official developer documentation.

Wati's API support for multiple WhatsApp numbers