EmbedAuthenticationHow to
Generate a sandbox token
Sandbox tokens in Toucan AI let you test and validate your embedded analytics in a safe, controlled environment—before rolling out to production.
Objective
In this tutorial, you will learn how to generate a sandbox token in Toucan AI. Sandbox tokens allow you to test embedding your visualizations and dashboards in a controlled environment before using them in production.
Prerequisites
- A Toucan AI account.
- An API key (as seen in the previous tutorial on how to generate a sandbox API key).
Steps
1. Access the Settings Menu
- From the main interface, click on the Settings button in the menu.
2. Navigate to the Embed Tab
- In the Settings menu, click on the Embed tab to access token generation settings.
3. Find the Token Generation Sandbox Section
- Scroll down to the Token Generation Sandbox section within the Embed tab.
- This section allows you to generate tokens specifically for testing and embedding purposes.
4. Paste Your API Key
- In the Token Generation Sandbox, you will see a field to paste your API key.
- Copy your API key (generated in the previous tutorial) and paste it into this field.
5. Generate the Token
- If needed, complete Custom Attributes to test your Row Level Security
- After pasting the API key, click the Generate Token button.
- A sandbox token will be generated and displayed on the screen. This token is valid for a limited time (1 hour by default) and can be used to test embedding visualizations or dashboards.

6. Copy and Store the Token
- Copy the token to use it for embedding dashboards and testing your integrations.
- Store the token securely in your password manager for future use.
Conclusion
Congratulations! You have successfully generated a sandbox token in Toucan AI. This token can now be used to test embedding dashboards and charts within your application in a safe environment before going live in production.
Suggested Next Steps: Token Introspection!