Summary
To connect your application or integration with Wati, you need an API token and the correct API endpoint URL. This guide explains how to generate a new API token, configure its expiry and permissions, and find the correct endpoint URL for v1, v2, and v3 APIs.
Instructions
Generate an API token in Wati
Follow these steps to generate a new API token:
Log in to your Wati account.
Go to Connectors > API Tokens.
Click Generate new token.

Enter a name for your token, if prompted.
Set the token's expiry duration based on your requirements.
Under Scope, select the permissions required for your integration. Select Select all if your integration needs all available permissions.

Click the generate option and copy the token.
Important
Your API token is displayed only once when you generate it. Copy and store it securely before closing the window. If you lose the token, you must generate a new one and update your integration.
The older Bearer Token previously available under API Docs page expired when the associated user's password was changed. This behaviour applies only to the legacy tokens and does not apply to newly generated API tokens. New API tokens remain valid until their configured expiry date or until they are manually rotated.
Find your API Endpoint
You can find your API Endpoint on the same page as tokens.
Wati uses the following base URL (host) for API requests:
https://live-mt-server.wati.ioThe endpoint URL format depends on the API version you are using.
For v1 and v2 APIs
Include your Wati tenant ID immediately after the base URL, followed by the API path.
https://live-mt-server.wati.io/{tenantId}/api/v1/...Replace {tenantId} with your Wati tenant ID.
For v3 APIs
Do not include your tenant ID in the URL. Use the v3 API path directly after the base URL.
https://live-mt-server.wati.io/api/ext/v3/...Important: Do not add /{tenantId}/ to v3 API endpoint URLs. This will result in an incorrect endpoint URL.
Important notes about API tokens
Token expiry: Your API token remains valid until its configured expiry date or until it is manually rotated.
Token security: Keep your API token confidential. Do not share it publicly or expose it in client-side code.
Token permissions: Select the permissions your integration needs when generating the token.
Token replacement: If you generate a replacement token, update your integration to use the new token.
Legacy Bearer Token: The older Bearer Token previously available under API Docs is no longer available. You must generate a new API token under Connectors > API Tokens.
Wati introduced the new token generation process to improve security. It allows you to configure the token's expiry duration and permissions, which were not available with the older Bearer Token.
For more information about available API endpoints and operations, refer to the Wati API documentation.
Frequently Asked Questions (FAQs)
API token generation and authentication
1. Where can I generate an API token in Wati?
You can generate an API token by logging in to your Wati account and navigating to Connectors > API Tokens. Click Generate new token, configure the token's expiry duration and permissions, and generate the token.
2. Is the older Bearer Token under API Docs still available?
No. The older Bearer Token previously available under API Docs is no longer available. You must generate a new API token under Connectors > API Tokens to authenticate your API requests.
3. Why does Wati require generating a new API token?
Wati introduced the new API token generation process to improve security. It allows you to configure the token's expiry duration and select the permissions granted to it.
API token management
4. Can I retrieve a previously generated API token or configure its expiry duration?
No. You cannot retrieve a previously generated API token because Wati displays the token only once when it is created.
You can configure the expiry duration when generating a new API token. The token remains valid until it expires or is manually rotated.
If you lose your API token, generate a new one under Connectors > API Tokens and update your integration to use it.
API endpoint URLs
5. When should I include my tenant ID in a Wati API endpoint URL?
Include your tenant ID immediately after the base URL when using Wati v1 and v2 API endpoints.
Do not include your tenant ID in v3 API endpoint URLs, which use the /api/ext/v3/ path.
Did this answer your question?