--- title: Teamwork Desk API Integration on Truto slug: teamworkdesk category: Helpdesk canonical: "https://truto.one/integrations/detail/teamworkdesk/" --- # Teamwork Desk API Integration on Truto **Category:** Helpdesk **Status:** Generally available ## Unified APIs ### Unified User Directory API - **Me** — - **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 Teamwork Desk 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 Teamwork Desk.** The Proxy API is a 1-to-1 mapping of the Teamwork Desk 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 agent provisioning and deprovisioning across helpdesk tools** — Identity management and IT onboarding platforms can use Truto's Unified User Directory API to create, update, and deactivate Teamwork Desk agent accounts as part of a zero-touch provisioning workflow — ensuring new hires get inbox access on day one and departed employees are removed immediately. - **Sync support agent directories into customer success platforms** — Customer success tools need to know which agents are handling which accounts. By pulling Teamwork Desk users and roles through Truto, a CSP can map agent assignments to client health scores and ensure the right team members are flagged during escalation workflows. - **Centralize user and role data for compliance and access auditing** — GRC and security platforms can query Teamwork Desk user directories via Truto to audit who has agent access, what permission levels are assigned, and whether part-time vs. full-time agent licensing is correctly allocated — all without building a custom connector. - **Power workforce analytics with helpdesk staffing data** — Workforce planning and analytics SaaS products can ingest Teamwork Desk agent rosters and roles to model support team capacity, track headcount changes over time, and correlate staffing levels with operational metrics from other systems. ## What you can build - **Automated agent onboarding and offboarding** — Provision new Teamwork Desk agent accounts with the correct role and inbox access when an employee is hired, and deactivate them instantly upon departure. - **Cross-platform user directory sync** — Keep Teamwork Desk agent profiles in sync with your product's internal user directory, ensuring names, roles, and email addresses stay consistent across tools. - **Role-based access audit dashboard** — Display a unified view of which Teamwork Desk users hold full-time vs. part-time agent roles, enabling license cost optimization and access compliance checks. - **Authenticated user context via Me endpoint** — Fetch the currently authenticated Teamwork Desk user's identity and permissions to personalize your app's UI and scope data access appropriately for each connected account. - **Multi-tool agent roster consolidation** — Pull Teamwork Desk users alongside agents from other helpdesk platforms using Truto's Unified User Directory API to build a single, normalized support team roster inside your product. ## FAQs ### Which Truto Unified APIs are available for Teamwork Desk today? Teamwork Desk is currently supported through Truto's Unified User Directory API, which covers the Me, Roles, and Users resources. Additional tools and unified API resources (such as Tickets, Companies, or HappinessRatings) can be built on request. ### How does authentication work for Teamwork Desk integrations via Truto? Truto handles the authentication flow with Teamwork Desk on your behalf. Your end users connect their Teamwork Desk accounts through Truto's embedded linking experience, so you never need to manage API keys or OAuth tokens directly. ### Does Truto handle pagination and rate limiting for the Teamwork Desk API? Yes. Truto abstracts away Teamwork Desk's REST API pagination and respects its rate limits automatically, so you can request full datasets without writing retry or cursor-management logic. ### Can I distinguish between full-time and part-time agents when pulling users? Teamwork Desk assigns specific license types — Full-Time Agent (unlimited replies) and Part-Time Agent (limited to 10 replies per month). The Roles resource in the Unified User Directory API maps to these distinctions, allowing you to differentiate agent types programmatically. ### What if I need access to Teamwork Desk data beyond users and roles, like tickets or companies? Truto builds new tools and unified API resources on request. If your use case requires Tickets, Companies, Customers, HappinessRatings, or other Teamwork Desk data models, contact Truto and the team will scope and deliver the integration. ### Can I use the same integration code to support other helpdesk platforms? Yes. Truto's Unified User Directory API provides a normalized schema across multiple helpdesk and SaaS platforms. Code you write against the Users, Roles, and Me resources works across any supported provider, including Teamwork Desk, with no provider-specific logic required.