--- title: Zoho People API Integration on Truto slug: zohopeople category: HRIS canonical: "https://truto.one/integrations/detail/zohopeople/" --- # Zoho People API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employees** — Represents an employee in HRIS - **Groups** — Groups represent the groups for an Employee - **Timeoff Requests** — Represent the time off requests for an Employee ## How it works 1. **Link your customer's Zoho People 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 Zoho People.** The Proxy API is a 1-to-1 mapping of the Zoho People 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 employee provisioning from Zoho People** — SaaS companies offering IT access management or identity tools can sync employee records from Zoho People to automatically provision or deprovision user accounts when employees are hired, terminated, or change roles. - **Sync org structure for approval routing** — Platforms that require manager hierarchies or department-based workflows can pull Groups and Employee reporting relationships from Zoho People, ensuring approval chains and team assignments always reflect the latest HR data. - **Power workforce scheduling with time-off awareness** — Shift scheduling or project management SaaS can read approved Timeoff Requests from Zoho People to automatically block unavailable employees, preventing scheduling conflicts and reducing manual coordination. - **Drive department-based automation in your product** — LMS, compliance, or training platforms can sync Employees and Groups to auto-enroll users into the correct programs whenever their department or role changes in Zoho People. - **Build a real-time employee directory for your users** — Any SaaS product that needs to display or reference a customer's workforce — from expense tools to internal comms platforms — can use the Zoho People integration to keep an up-to-date employee directory without asking users to manually import CSV files. ## What you can build - **Automated user lifecycle management** — Provision and deprovision user accounts in your product by syncing employee status changes from Zoho People in near real-time. - **Department-based access control** — Map Zoho People departments and designations to roles or workspaces in your product so new employees land in the right context automatically. - **Manager hierarchy sync** — Pull reporting relationships from Zoho People to power approval workflows, escalation chains, or org chart visualizations inside your app. - **Time-off aware availability calendar** — Display employee availability by overlaying approved leave data from Zoho People onto your product's scheduling or resource planning views. - **Incremental employee data sync** — Keep your product's user records fresh by syncing only recently modified employee profiles from Zoho People, minimizing API usage and latency. - **One-click Zoho People connection for your end users** — Offer a seamless OAuth-based setup flow so your customers can connect their Zoho People account to your product in seconds, with Truto handling token management and refresh. ## FAQs ### What authentication method does Zoho People use? Zoho People uses OAuth 2.0. Truto manages the full auth lifecycle including token refresh, so your end users authenticate via a standard OAuth consent flow and you never need to handle credentials directly. ### What data models are available through Truto's Unified HRIS API for Zoho People? The Unified HRIS API covers Employees, Groups (departments and designations), and Timeoff Requests. These map to Zoho People's Forms-based architecture — specifically the employee, department, designation, and leave form link names. ### Does the integration support custom fields from Zoho People? Zoho People is built on a highly customizable Forms architecture, meaning most customers have custom fields on employee and leave records. Truto's Unified API returns standard fields in a normalized schema, and custom fields can be accessed as part of the integration. Contact Truto for specifics on custom field passthrough. ### Can I write data back to Zoho People, such as creating time-off requests? Zoho People's API supports write operations like inserting leave records. However, specific write tools for the Truto integration are built on request. Reach out to Truto to discuss bidirectional time-off or other write workflows. ### How does Truto handle Zoho People's API rate limits and pagination? Truto abstracts away Zoho People's pagination and rate limit handling. You interact with a single Unified API, and Truto manages page cursors and request throttling behind the scenes so you don't hit limits or miss records. ### Are there additional Zoho People tools or resources I can request beyond the Unified HRIS API? Yes. The current Unified HRIS API covers Employees, Groups, and Timeoff Requests. If you need access to other Zoho People data — such as attendance, timesheets, or performance reviews — Truto builds additional tools on request to match your use case.