Overview

Torii integrates with Metabase and syncs:

• Users (with status and role)
• Licenses

Requirements

To connect this integration, we require the following:

Accounts & Permissions

• A Metabase account with administrator access
• Access to the Metabase admin console to create API keys

Required keys

• Metabase Instance URL: Your Metabase instance URL (e.g., https://your-instance.metabase.com or https://yourcompany.metabaseapp.com for Metabase Cloud)
• API Key: A Metabase API key with administrator permissions

How to Generate the Required Values

Step 1: Find your Metabase Instance URL

1. Log in to your Metabase instance
2. Check the URL in your browser's address bar
   • For Metabase Cloud: typically https://yourcompany.metabaseapp.com
   • For self-hosted: your custom domain or server URL
3. Alternatively, go to Admin → Settings → General and check the Site URL field
4. Copy the full URL (including https://)

Step 2: Generate an API Key

1. Log in to Metabase as an administrator
2. Click the gear icon in the upper right corner → Admin settings
3. Go to the Settings tab
4. In the left menu, select Authentication
5. Scroll to the API Keys section and click Manage
6. Click Create API Key
7. Enter a Key name (e.g., "Torii Integration")
8. Select a Group: Choose Administrators group for full access (required to read user data)
9. Click Create

10. Important
    The API key will be displayed only once. Copy and save it immediately. If you lose it, you'll need to regenerate it.

How to Connect the Integration

1. Go to the Integrations page in Torii
2. Search for Metabase and click Connect
3. Enter the following values:
   • Metabase Instance URL: Your Metabase instance URL (e.g., https://your-instance.metabase.com)
   • API Key: The API key you generated
4. Click Connect

Important Notes

• API Key Security: The API key is shown only once when created. Save it securely. If lost, regenerate it in Metabase admin settings.
• Permissions: The API key must be assigned to the Administrators group to access user data. Keys assigned to other groups may have limited permissions.

Q&A

Q: What happens if I provide an API key that doesn't have administrator permissions?
A: The integration will fail to sync user data. You'll receive an error message indicating insufficient permissions. Ensure the API key is assigned to the Administrators group in Metabase.

For any further questions, please contact Torii Support.