Summary
Your Bearer Token is required for authenticating API requests in WATI. However, it will expire if you change your password. When this happens, you must update your existing or new API calls with the new token.
This guide explains how to locate your API Endpoint URL and Bearer Token in your WATI account.
Instructions
Steps to Find Your API Endpoint URL and Bearer Token
Follow these simple steps to retrieve your API credentials:
1. Log in to your WATI account.
2. In the top navigation menu, go to API Docs.
3. On the API Docs page, you will find both:
API Endpoint URL
Bearer Token
4. Click to copy the credentials and use them in your API requests.
Important notes
If you change your password, your current Bearer Token will expire. You must generate a new one and update it in your API requests.
Always keep your Bearer Token secure and avoid sharing it publicly.
For more details, refer to the WATI API Documentation.
What is the difference between the “Create new token” and the bearer token available under API Docs?
The bearer token available under API Docs is the older token type. This token can be automatically rotated if the user resets their password, is deleted, logs out from all active sessions, or if the token itself is rotated.
The Create new token option generates a newer token that does not depend on user-level actions. This token remains valid until it is manually rotated or reaches its configured expiry date. The token is displayed only once at the time of generation, so it should be copied and stored securely.
Frequently Asked Questions (FAQs)
API credentials in Wati
1. What is the Bearer Token used for in Wati APIs?
The Bearer Token is used to authenticate API requests made to Wati. It must be included in API requests to verify that the request is authorized to access the Wati account.
2. Where can you find the API Endpoint URL and Bearer Token in Wati?
You can find the API Endpoint URL and Bearer Token by logging in to your Wati account and navigating to API Docs in the top navigation menu. The API Docs page displays both the API Endpoint URL and the Bearer Token that can be copied and used in API requests.
3. How do you retrieve the API Endpoint URL and Bearer Token from Wati?
To retrieve the API Endpoint URL and Bearer Token, log in to your Wati account, open API Docs from the top navigation menu, locate the API Endpoint URL and Bearer Token on the API Docs page, and copy the credentials for use in your API requests.
Token behavior and management
4. What happens to the Bearer Token if you change your Wati account password?
If you change your Wati account password, the existing Bearer Token will expire. When this happens, you must generate a new Bearer Token and update it in your API requests.
5. How should the Bearer Token be handled for security?
The Bearer Token should always be kept secure and should not be shared publicly because it is used to authenticate API requests to your Wati account.
Token types in Wati
6. What is the difference between the “Create new token” and the Bearer Token available under API Docs?
The Bearer Token available under API Docs is the older token type. This token can be automatically rotated if the user resets their password, is deleted, logs out from all active sessions, or if the token itself is rotated.
The Create new token option generates a newer token that does not depend on user-level actions. This token remains valid until it is manually rotated or reaches its configured expiry date. The token is displayed only once at the time of generation and must be copied and stored securely.