--- title: PeopleHR API Integration on Truto slug: peoplehr category: HRIS canonical: "https://truto.one/integrations/detail/peoplehr/" --- # PeopleHR API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Benefits** — Benefits represent the benefits for an Employee - **Employee Compensations** — Represent the compensation configuration for an Employee - **Employees** — Represents an employee in HRIS - **Timeoff Requests** — Represent the time off requests for an Employee ## How it works 1. **Link your customer's PeopleHR 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 PeopleHR.** The Proxy API is a 1-to-1 mapping of the PeopleHR 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 employee census data for automated benefits enrollment** — Benefits and insurance platforms can pull employee demographics, employment status, and compensation data from PeopleHR to automatically enroll new hires and revoke coverage on termination — eliminating manual CSV uploads and reducing compliance risk. - **Feed approved leave data into workforce scheduling** — Workforce management tools can ingest approved time-off requests from PeopleHR so that shift planners automatically account for employee absences, preventing rostering conflicts and reducing manual coordination between HR and operations. - **Ingest compensation data for pay equity and benchmarking** — Compensation review and equity management platforms can continuously read salary, pay period, and job title data from PeopleHR, giving HR leaders accurate inputs for modeling bonus pools, equity grants, and pay band analysis without manual data entry. - **Trigger IT provisioning and de-provisioning from employee lifecycle events** — IT asset management and identity tools can detect new hires and terminations in PeopleHR to automatically provision or revoke software licenses, ship hardware, and manage access — turning onboarding and offboarding into zero-touch workflows. - **Keep payroll systems in sync with HR changes** — Payroll platforms can read employee details and compensation changes from PeopleHR to ensure that new hires, salary adjustments, and terminations are reflected accurately without duplicate data entry across systems. ## What you can build - **Real-time employee directory sync** — Automatically import and keep up-to-date employee profiles, job titles, departments, and manager hierarchies from PeopleHR using the Unified HRIS API's Employees model. - **Absence-aware scheduling engine** — Pull approved time-off requests from PeopleHR via the Timeoff Requests model and automatically block those dates in your scheduling or resource planning UI. - **Automated benefits eligibility engine** — Use employee status and compensation data from PeopleHR to determine benefits eligibility and auto-enroll or off-board employees from coverage plans. - **Compensation change feed for analytics dashboards** — Continuously ingest salary and compensation updates from PeopleHR's Employee Compensations model to power live pay equity reports and budget forecasting tools. - **Lifecycle-triggered workflow automation** — Detect employee status changes — new hire, active, terminated — from PeopleHR and use them to kick off downstream workflows like provisioning, offboarding checklists, or notifications. - **One-click PeopleHR connection for your end users** — Offer your customers a seamless connect flow to link their PeopleHR account to your product, with Truto handling authentication and token management behind the scenes. ## FAQs ### How does authentication work with PeopleHR? PeopleHR uses API key authentication. Your end users generate an API key from their PeopleHR admin panel, and Truto securely stores and manages the credential for ongoing API access. ### What are PeopleHR's API rate limits, and how does Truto handle them? PeopleHR enforces a strict rate limit of 30 API calls per minute per IP address. Truto manages request throttling and retry logic automatically so your integration stays within limits without manual intervention. ### Which data models are available through Truto's Unified HRIS API for PeopleHR? Truto's Unified HRIS API supports four models for PeopleHR: Employees (demographics, job details, employment status, manager hierarchy), Employee Compensations (salaries, pay rates), Timeoff Requests (leave and absence data), and Benefits (enrollment information). ### Does PeopleHR support webhooks for real-time data sync? Yes, PeopleHR natively supports webhooks. Given the strict 30-call-per-minute rate limit, webhooks are highly recommended for real-time event-driven workflows like detecting new hires or leave approvals instead of relying solely on polling. ### Are custom tools or additional endpoints available beyond the Unified HRIS API? Truto currently supports PeopleHR through the Unified HRIS API. Additional custom tools or endpoints beyond the unified models can be built on request to cover PeopleHR-specific capabilities like document management or custom fields. ### What regions and company sizes does this integration best serve? PeopleHR is predominantly used by UK and European SMEs and mid-market organizations (50–1,000 employees). If your product targets this market, offering a PeopleHR integration covers a significant share of the HRIS landscape with over 7,000 companies on the platform.