--- title: Aircall API Integration on Truto slug: aircall category: Voice canonical: "https://truto.one/integrations/detail/aircall/" --- # Aircall API Integration on Truto **Category:** Voice **Status:** Generally available ## 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. - **Users** — The User object represents a User. ## How it works 1. **Link your customer's Aircall 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 Aircall.** The Proxy API is a 1-to-1 mapping of the Aircall 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 - **Map recruiter identities across your ATS and Aircall** — Applicant tracking systems need to attribute call recordings and logs to the correct recruiter. By syncing user directories between your platform and Aircall, you ensure every interview call is automatically tied to the right recruiter profile without manual mapping. - **Sync team structures for call routing and permissions** — SaaS platforms offering voice features need to understand how their customers' teams are organized in Aircall. Pulling groups and users lets you mirror Aircall team structures into your product, enabling features like team-based call analytics, manager-level dashboards, and role-aware workflows. - **Automate agent onboarding and deprovisioning** — Workforce management and operations platforms can read Aircall's user directory to detect new agents or removed agents, keeping internal rosters in sync and ensuring permissions, assignments, and reporting stay accurate without manual intervention. - **Power sales coaching dashboards with accurate rep data** — AI coaching and conversation intelligence platforms need a reliable roster of sales reps and their team assignments to attribute call performance metrics correctly. Syncing Aircall's user directory provides the foundation for per-rep and per-team scorecards. ## What you can build - **Automatic agent-to-user identity mapping** — Match Aircall users to internal user profiles in your platform using synced user directory data, so call activity is always attributed to the right person. - **Team-aware analytics and reporting** — Pull Aircall groups into your product to power team-level roll-ups, letting managers see aggregated call metrics for their specific squad. - **Real-time agent roster sync** — Keep your platform's list of active agents continuously aligned with Aircall's user directory, automatically reflecting new hires, departures, and team reassignments. - **Role-based access control mirroring** — Use Aircall group memberships to drive permissions in your own product — for example, restricting call recording access to users who belong to a specific Aircall team. - **Onboarding status detection for new agents** — Surface newly added Aircall users in your platform's setup flow so admins can quickly configure integrations, assign sequences, or enroll reps in training workflows. ## FAQs ### How does authentication work for the Aircall integration? Aircall supports OAuth 2.0 for third-party integrations. Truto handles the full OAuth flow — token exchange, storage, and refresh — so your end users can connect their Aircall accounts with a single click without you managing credentials. ### What data can I access through Truto's Unified User Directory API for Aircall? You can read Users (agent profiles including name, email, and availability metadata) and Groups (team structures) from Aircall through the Unified User Directory API. This gives you reliable identity and organizational data to map against your own platform's user model. ### Are there additional Aircall-specific tools available beyond the Unified User Directory API? Not yet — additional tools covering calls, numbers, tags, webhooks, and other Aircall-specific resources are built on request. If your use case requires access to call logs, recordings, or the dial endpoint, reach out and Truto can prioritize building those capabilities. ### Does Truto handle pagination and rate limits for Aircall? Yes. Aircall's API enforces rate limits and uses cursor-based pagination. Truto abstracts both, so you get consistent, complete data sets through a single unified interface without writing retry logic or pagination handling. ### How fresh is the user directory data from Aircall? Data is fetched from Aircall's API in real time or near-real time when you make requests through Truto. There is no stale cache layer — each sync pulls the latest state of users and groups from the Aircall account. ### Can my end users connect multiple Aircall accounts? Yes. Truto supports multiple linked accounts, so if your customer operates separate Aircall workspaces for different teams or regions, each can be connected and managed independently through your integration.