Skip to main content

​
Before you start

To authenticate with the WotNot API, you need:
  • A WotNot account
  • Access to the account’s Developer settings
  • Your WotNot account token
  • The WotNot API endpoint URL

​
Get your account token

Your account token is available from the WotNot dashboard.
  1. Log in to your WotNot account.
  2. Go to Settings.
  3. Select Account Settings.
  4. Open the Developer section.
  5. Copy your Account Token.
Your account token provides access to APIs associated with your WotNot account. Store it securely and treat it like a password.
Screenshot 2026 09 08 143652
Never share your account token publicly or include it directly in browser-side code. Store it securely on your server or in an environment variable.

​
API endpoint

All WotNot API requests are sent to:
The endpoint path depends on the API operation you want to perform. For example:

IMPORTANT

 Add https://api.wotnot.io/ before the API you want to use 

​
Authenticate your requests

Pass your account token as a Bearer token in the Authorization header.
For APIs that accept JSON, also include:
Example API request: The following example creates a knowledge base using an authenticated request.
If the token is valid and the request is correctly formatted, WotNot processes the request and returns the API response.

​
Authentication header

Some endpoints use a different content type. For example, APIs that upload files or text sources may require multipart/form-data. Always use the content type specified by the individual endpoint.

​
Common authentication errors

​
Invalid or missing token

If the request does not contain a valid account token, the API may return an authentication error. Example:
Check the following:
  • The Authorization header is included.
  • The value starts with Bearer.
  • There is a space between Bearer and the token.
  • The token is copied correctly.
  • The token belongs to the WotNot account containing the resource you are trying to access.

​
Avoid

Do not:
  • Add the token directly to frontend or browser-side code.
  • Commit the token to a public Git repository.
  • Share the token in screenshots or documentation.
  • Include the token in URLs or query parameters.
  • Store the token in publicly accessible files.
If your token is exposed, treat it as compromised and contact WotNot Support for assistance.

​
Authentication checklist

Before troubleshooting an API request, verify:
  • You copied the correct account token.
  • The Authorization header is present.
  • The header uses the Bearer <token> format.
  • You are using https://api.wotnot.io as the API host.
  • The endpoint path is correct.
  • Required headers are included.
  • The resource belongs to the WotNot account associated with your token.
Last modified on October 23, 2026