--- title: Mural API Integration on Truto slug: mural category: Knowledge Management canonical: "https://truto.one/integrations/detail/mural/" --- # Mural API Integration on Truto **Category:** Knowledge Management **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. - **Workspaces** — Workspaces represent concepts like teams, workspaces, projects in apps that support them ## How it works 1. **Link your customer's Mural 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 Mural.** The Proxy API is a 1-to-1 mapping of the Mural 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 user provisioning and deprovisioning across Mural workspaces** — SaaS companies offering enterprise onboarding or identity management can sync their user directory with Mural to automatically provision new hires into the correct workspaces and remove access when employees leave — without manual admin work. - **Centralize workspace and user visibility for IT governance** — IT management and security platforms can pull Mural's organization, user, and workspace data into a unified dashboard, giving admins a single pane of glass to monitor who has access to which collaborative workspaces across the enterprise. - **Enrich product analytics with visual collaboration usage data** — SaaS platforms focused on productivity analytics or digital workplace optimization can ingest Mural's user and workspace structure to correlate visual collaboration patterns with broader team productivity metrics. - **Power cross-platform access reviews for compliance workflows** — GRC and compliance automation tools can pull Mural's user and workspace membership data to verify that only authorized personnel have access to sensitive strategy and design canvases, supporting SOC2 and ISO 27001 access control requirements. ## What you can build - **Unified employee directory with Mural workspace membership** — Surface each employee's Mural workspace assignments alongside their roles in other connected apps, giving IT admins a complete view of access across the organization. - **Automated Mural seat lifecycle management** — Trigger provisioning or deprovisioning of Mural users based on HR system events like new hires, role changes, or offboarding — routed through Truto's Unified User Directory API. - **Cross-app workspace access audit report** — Generate a consolidated report showing which users belong to which Mural workspaces, mapped against their identity records in your directory, for periodic access reviews. - **Organization-level Mural usage dashboard** — Pull organizational and workspace structure from Mural to display team-level adoption metrics and workspace distribution within your SaaS product. - **Role-based workspace assignment engine** — Automatically assign users to specific Mural workspaces based on their department, role, or project membership synced from your customer's identity provider. ## FAQs ### What Mural data can I access through Truto today? Truto maps Mural to the Unified User Directory API, which covers Organizations, Users, and Workspaces. Specific tools for deeper Mural resources (elements, murals, rooms) are not yet available but can be built on request. ### How does authentication work for the Mural integration? Mural supports OAuth 2.0 for API access. Truto handles the full OAuth flow — token acquisition, refresh, and storage — so your end users can connect their Mural accounts without you managing auth directly. ### Can I access Mural's Enterprise Admin API through Truto? Truto's Unified User Directory API maps to Mural's organizational and user management endpoints. If you need access to additional Enterprise API capabilities like audit logs or SCIM provisioning beyond what the Unified API covers, Truto can build custom tools on request. ### What if I need access to Mural canvas elements, templates, or webhooks? These are not covered by the current Unified User Directory API mapping. However, Truto builds integration tools on request — if your use case requires element CRUD, template cloning, or webhook subscriptions, reach out and the team can scope and build the integration. ### How does Truto handle Mural's API rate limits? Truto manages rate limiting, pagination, and retries automatically at the proxy layer. Your application interacts with a consistent Unified API interface without needing to handle Mural-specific throttling logic. ### Can my customers connect multiple Mural workspaces through a single integration? Yes. Truto's architecture supports multiple connected accounts per end user, so your customers can authorize access to different Mural workspaces or organizations as needed.