--- title: Retool API Integration on Truto slug: retool category: Application Development canonical: "https://truto.one/integrations/detail/retool/" --- # Retool API Integration on Truto **Category:** Application Development **Status:** Beta ## Unified APIs ### Unified User Directory API - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Retool account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Retool.** The Proxy API is a 1-to-1 mapping of the Retool API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Automate employee provisioning and deprovisioning in Retool** — HR and identity management SaaS companies can sync their employee lifecycle events to automatically create, update, or suspend user accounts in their customers' Retool organizations — ensuring access to sensitive internal tools is always in sync with employment status. - **Enforce role-based access control across internal tooling** — Security and compliance platforms can map organizational roles to Retool groups, ensuring that when an employee changes departments or roles, their permissions on internal dashboards and admin panels are updated immediately without manual intervention. - **Centralize user directory management across SaaS tools including Retool** — IT management and SaaS governance platforms can offer a single pane of glass for managing user accounts across all tools their customers use, with Retool as a key integration point for internal application access. - **Audit and report on internal tool access for compliance** — GRC and compliance SaaS companies can pull user and group data from Retool to generate access reports, flag orphaned accounts, and demonstrate SOC 2 or ISO 27001 compliance for internal tooling environments. ## What you can build - **Automated Retool user provisioning on employee onboarding** — Automatically create a Retool user account and assign them to the correct permission groups the moment they are added in your customer's HR or identity system. - **Real-time access revocation on offboarding** — Instantly suspend or delete a user's Retool account when they are terminated or deactivated in the source-of-truth directory, closing the access gap in seconds. - **Cross-platform user directory dashboard** — Surface a unified view of all user accounts across Retool and other connected applications, letting IT admins spot discrepancies and orphaned accounts at a glance. - **Group membership sync for RBAC enforcement** — Map organizational roles or department tags to Retool groups so that permission boundaries are always consistent with the customer's identity provider. - **Compliance-ready access audit reports** — Generate exportable reports showing which users have access to Retool, what groups they belong to, and when their accounts were last modified — ready for auditor review. ## FAQs ### What authentication method does Retool's API use? Retool's administrative API (v2) uses API key-based authentication. Your end users generate an API key from their Retool organization settings, and Truto handles storing and passing this securely with each request. ### Which Retool resources can be accessed through Truto's Unified User Directory API? Truto's Unified User Directory API maps to Retool's Users endpoints, allowing you to read, create, update, and manage user accounts within a Retool organization through a standardized schema. ### Are Retool-specific tools available out of the box in Truto? Retool integration tools are built on request. Once you indicate the need, Truto's team builds and tests the connector to Retool's API, covering auth, pagination, and error handling so you don't have to. ### Can I manage Retool group assignments through this integration? Retool's API exposes group management endpoints. While the Unified User Directory API focuses on user-level operations, group assignment workflows can be supported as part of a custom connector build through Truto. ### How does Truto handle pagination and rate limits for Retool's API? Truto abstracts away Retool's API pagination logic and respects its rate limits automatically, so your application receives complete data sets without needing to implement retry or cursor management logic. ### Does this integration support both Retool Cloud and self-hosted Retool? Retool's administrative API is available on both Cloud and self-hosted deployments. As long as the API endpoint is reachable and a valid API key is provided, Truto can connect to either environment.