--- title: Hootsuite API Integration on Truto slug: hootsuite category: Default canonical: "https://truto.one/integrations/detail/hootsuite/" --- # Hootsuite API Integration on Truto **Category:** Default **Status:** Beta ## Unified APIs ### Unified User Directory API - **Groups** — Groups are a collection of users in the source application. In some applications, they might also be called Teams. - **Me** — - **Organizations** — Organizations are the top level entity in the source application. Users are associated with an organization. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Hootsuite 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 Hootsuite.** The Proxy API is a 1-to-1 mapping of the Hootsuite 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 Hootsuite teams and members into your SaaS for permission mapping** — If your product manages roles or permissions, you can use Truto's Unified User Directory API to pull Hootsuite Organizations, Teams (Groups), and Members (Users) so your app automatically mirrors the customer's Hootsuite team structure without manual setup. - **Auto-provision and deprovision users across your platform and Hootsuite** — Identity and access management SaaS companies can keep user directories in sync — when an employee is added or removed in Hootsuite, your product reflects the change instantly, reducing security gaps and manual admin work. - **Enrich customer profiles with Hootsuite organizational context** — CRM and helpdesk platforms can pull Hootsuite org and team data to understand which social teams exist within a customer account, enabling smarter routing, segmentation, and reporting tied to the customer's real organizational structure. - **Map social team agents to your product's internal roles** — Omnichannel support or collaboration tools can read Hootsuite's team hierarchy and automatically map social media agents to corresponding roles in your platform, eliminating manual onboarding steps for each connected account. ## What you can build - **Hootsuite org and team directory sync** — Automatically import Hootsuite Organizations and Teams (Groups) into your app so customers never have to manually recreate their team structure. - **Real-time member roster mirroring** — Keep your product's user list continuously in sync with Hootsuite Members (Users), reflecting additions, removals, and role changes as they happen. - **Authenticated user context detection** — Use the Me endpoint to identify the currently connected Hootsuite user and personalize your app's experience, permissions, or dashboards based on their identity. - **Cross-platform team mapping dashboard** — Build a UI that lets customers visually map their Hootsuite teams to groups in your product, powered by the unified Groups and Users data from Truto. - **Automated user offboarding alerts** — Detect when a Hootsuite member is removed from an organization and trigger downstream actions in your product — revoking access, reassigning tasks, or notifying admins. ## FAQs ### What Hootsuite data can I access through Truto today? Truto's Unified User Directory API supports reading Hootsuite Organizations, Groups (Teams), Users (Members), and the authenticated user context (Me). Additional Hootsuite-specific tools (e.g., Messages, Media, Social Profiles) are not pre-built but can be built on request. ### How does authentication work for Hootsuite integrations via Truto? Truto handles the full OAuth flow for Hootsuite. Your end users connect their Hootsuite accounts through Truto's embedded auth experience, and Truto manages token storage, refresh, and revocation so you never touch credentials directly. ### Does Hootsuite support SCIM for user provisioning? Yes, Hootsuite exposes SCIM 2.0 endpoints for automated user provisioning and deprovisioning. Truto's Unified User Directory API can leverage these endpoints to keep user directories in sync. ### What if I need Hootsuite endpoints beyond the Unified User Directory API? Truto builds integration tools on request. If you need access to Hootsuite's Messages, Media, or Social Profiles endpoints, contact Truto and they will build and expose those resources for your use case. ### How does Truto handle Hootsuite's rate limits and pagination? Truto abstracts away API-specific quirks including rate limiting, pagination, and retry logic. Your application interacts with a consistent unified API, and Truto manages the underlying Hootsuite API constraints transparently. ### Can I map Hootsuite's hierarchical org structure to my product's data model? Yes. Hootsuite's hierarchy — Organizations at the top, Teams within them, Members within Teams — maps cleanly to Truto's Unified User Directory resources (Organizations, Groups, Users), making it straightforward to mirror this structure in your app.