--- title: Tableau API Integration on Truto slug: tableau category: Business Intelligence canonical: "https://truto.one/integrations/detail/tableau/" --- # Tableau API Integration on Truto **Category:** Business Intelligence **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Roles** — The Role object represents a role of a User. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Tableau 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 Tableau.** The Proxy API is a 1-to-1 mapping of the Tableau 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 - **Sync user roles to Tableau for embedded analytics access control** — SaaS platforms embedding Tableau dashboards need to ensure that user permissions stay in sync. By mapping your app's RBAC to Tableau Site Roles and Groups via Truto's Unified User Directory API, you can automatically provision and deprovision Tableau users as roles change in your product. - **Automate Tableau user provisioning for enterprise customers** — Enterprise customers expect seamless onboarding. When a new user is added to your SaaS platform, automatically create a corresponding Tableau user with the correct Site Role and group membership — no manual admin work required on the Tableau side. - **Enforce row-level security through identity and group sync** — For SaaS products handling sensitive data (HR, finance, healthcare), keeping Tableau Groups aligned with your app's tenant or team structure ensures that embedded dashboards only show data each user is authorized to see. - **Offboard users from Tableau when they leave your platform** — When a customer's employee is removed or downgraded in your SaaS app, the integration should immediately reflect that change in Tableau — revoking access to dashboards and reports without requiring a separate admin action. ## What you can build - **Automated Tableau user provisioning on signup** — Create Tableau users with the appropriate Site Role (Viewer, Explorer) the moment a new user is added in your SaaS product. - **Role-to-SiteRole mapping engine** — Map your application's internal roles (e.g., Admin, Manager, Basic User) to Tableau Site Roles so permissions stay consistent across both systems. - **Group-based tenant isolation sync** — Automatically add and remove users from Tableau Groups based on their team or tenant assignment in your platform, enforcing data isolation for embedded dashboards. - **Real-time access revocation on role change** — When a user's role is downgraded or removed in your app, instantly update or deactivate their Tableau account to prevent unauthorized dashboard access. - **User directory audit dashboard** — Surface a unified view of which of your end users have active Tableau accounts and what roles they hold, making it easy for customer admins to audit access. ## FAQs ### What Unified APIs does Truto support for Tableau today? Truto supports the Unified User Directory API for Tableau, covering Users and Roles. This lets you programmatically list, create, update, and manage Tableau users and their Site Roles through a standardized interface. ### Are additional Tableau API capabilities (workbooks, data refresh, PDF export) available through Truto? Not as pre-built tools today. Tableau's REST API is extensive, and Truto can build additional tools on request to cover content automation, extract refresh triggers, view downloads, and more. Contact Truto to discuss your specific requirements. ### How does authentication work for the Tableau integration? Tableau supports Personal Access Tokens (PAT) and JWT-based authentication via Connected Apps for its REST API. Truto handles the auth flow so your end users can connect their Tableau Cloud or Tableau Server instance without you managing token lifecycle or session handling. ### Does this work with both Tableau Cloud and Tableau Server? Yes. Tableau's REST API is available on both Tableau Cloud (hosted by Salesforce) and self-hosted Tableau Server. Your end users provide their instance URL during the connection setup in Truto. ### How does Truto handle Tableau's API rate limits? Truto manages pagination and request throttling under the hood. Tableau applies rate limits that vary by deployment type and plan, and Truto's infrastructure automatically retries and backs off as needed so your integration doesn't break under load. ### What Tableau Site Roles can be assigned through the integration? You can assign any standard Tableau Site Role — including Creator, Explorer, Explorer (Can Publish), Viewer, and Unlicensed — through the Unified User Directory API, mapping them to roles in your own application's permission model.