Overview

Torii integrates with Retool and syncs:

• Users (status, role, last visit time)
• Licenses (Builder, Standard User, External User)
• Retool group membership
• Multi-account is supported — you can connect multiple Retool instances.
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.

Requirements

To connect this integration, we require the following:

Accounts & Permissions

• A Retool Enterprise plan.
• Organization admin access to create an API access token.

Required keys

• API Access Token — with the users:read, organization:read, and groups:read scopes. To enable workflow actions (user provisioning, deprovisioning, and group management), also add the users:write and groups:write scopes.
• Instance Host (Optional) — only for self-hosted Retool (e.g. retool.yourcompany.com). Leave blank for Retool Cloud.

How to Generate the Required Values

Step 1: Generate an API access token

1. In Retool, go to Settings → Retool API.
2. Click Create new.
3. Enter a name (and optional description).
4. Select the scopes: users:read, organization:read, groups:read. To enable workflow actions, also select users:write and groups:write.
5. Click Create and copy the token.

Step 2: Find your instance host (Required for self-hosted)

1. Your instance host is the domain you use to access Retool (e.g. retool.yourcompany.com).

How to Connect the Integration

1. Go to the Integrations page in Torii.
2. Search for Retool and click Connect.
3. Enter your API Access Token. For self-hosted Retool, also enter your Instance Host (Cloud users leave it blank).
4. Click Connect.

For any further questions, please contact Torii Support.