--- title: Freshcaller API Integration on Truto slug: freshcaller category: Helpdesk canonical: "https://truto.one/integrations/detail/freshcaller/" --- # Freshcaller API Integration on Truto **Category:** Helpdesk **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. - **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 Freshcaller 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 Freshcaller.** The Proxy API is a 1-to-1 mapping of the Freshcaller 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 telephony tools** — IT provisioning and identity management platforms can use Truto's Unified User Directory API to automatically create, update, and remove Freshcaller agent accounts when employees are onboarded or offboarded in a central HR system — eliminating manual seat management and reducing security risk. - **Keep call center teams in sync with your org chart** — Workforce management and org-chart tools can sync Freshcaller groups and roles with a canonical user directory, ensuring routing teams and permission levels always reflect the latest organizational structure without manual admin intervention. - **Build a unified agent roster across multiple helpdesk and telephony platforms** — SaaS products that serve support operations teams can pull user, group, and role data from Freshcaller alongside other helpdesk tools through a single Truto integration, giving their customers a consolidated view of who has access to what across all their support channels. - **Enforce role-based access policies across SaaS tools** — Security and compliance platforms can read Freshcaller roles and user assignments via Truto to audit whether agent permissions align with company-wide access policies, flagging over-provisioned accounts or orphaned seats. ## What you can build - **Automated Freshcaller agent onboarding** — Create new Freshcaller user accounts and assign them to the correct team and role the moment an employee is added to your customer's HR or identity system. - **Real-time seat deprovisioning on offboarding** — Automatically deactivate or remove a Freshcaller agent when they leave the organization, reclaiming license costs and closing access instantly. - **Cross-platform user directory dashboard** — Surface a unified roster of all Freshcaller users, groups, and roles alongside other helpdesk tools so admins can manage their support workforce from one screen. - **Role and group drift detection** — Continuously compare Freshcaller roles and group memberships against a source-of-truth directory, alerting admins when assignments drift from policy. - **Bulk team restructuring workflows** — Let support managers reorganize Freshcaller routing groups in bulk by syncing changes from a central directory or spreadsheet through Truto's unified API. ## FAQs ### What authentication method does Freshcaller use? Freshcaller's API uses API Key authentication, passed via the X-Api-Auth header. Truto handles storing and injecting this credential so your end users just provide their key during the connect flow. ### Which Truto Unified APIs are available for Freshcaller? Freshcaller is supported through the Unified User Directory API, which covers Users, Groups, and Roles. This lets you read and manage agent accounts, routing teams, and permission levels through a standardized schema. ### Are there Freshcaller-specific tools (calls, recordings, metrics) available in Truto today? Not yet. Freshcaller-specific tools such as calls, call recordings, and call metrics endpoints are built on request. Contact the Truto team to prioritize these for your use case. ### Does Truto handle Freshcaller API pagination automatically? Yes. Truto manages pagination across all integrated APIs, so you receive complete result sets for users, groups, and roles without writing your own cursor or offset logic. ### Can I write data back to Freshcaller through Truto, or is it read-only? The Unified User Directory API supports both read and write operations where the underlying Freshcaller API permits — for example, creating or updating user accounts and modifying group memberships. ### How fresh is the data when I query Freshcaller through Truto? Queries through Truto are proxied to the Freshcaller API in real time, so the data you receive is as current as what the Freshcaller API itself returns at the moment of the request.