--- title: PeopleForce API Integration on Truto slug: peopleforce category: HRIS canonical: "https://truto.one/integrations/detail/peopleforce/" --- # PeopleForce API Integration on Truto **Category:** HRIS **Status:** Beta ## Unified APIs ### Unified HRIS API - **Employee Compensations** — Represent the compensation configuration for an Employee - **Employees** — Represents an employee in HRIS - **Fields** — Represent the fields for various entities in the company - **Group Types** — Group types represent the types of group. - **Groups** — Groups represent the groups for an Employee - **Job Roles** — Represent the job roles in a company - **Locations** — Locations represent the locations in HRIS - **Timeoff Balances** — Represent the time off balances for an Employee - **Timeoff Policies** — Represent the time off policies in a company - **Timeoff Requests** — Represent the time off requests for an Employee - **Timeoff Types** — Represent the time off types in a company ## How it works 1. **Link your customer's PeopleForce 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 PeopleForce.** The Proxy API is a 1-to-1 mapping of the PeopleForce 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 PeopleForce** — IT management and identity platforms can listen for new hires and terminations in PeopleForce, then automatically provision or deprovision SaaS accounts, hardware, and access rights based on department and job role — eliminating manual IT tickets. - **Sync time-off data into resource planning tools** — Project management and professional services automation tools can pull approved time-off requests and balances from PeopleForce to automatically block employee capacity, preventing managers from scheduling unavailable team members on billable work. - **Power compensation analytics with real employee data** — HR analytics and equity management platforms can sync employee compensations, job roles, and locations from PeopleForce to deliver geography-specific benchmarking dashboards and pay equity reports to CPOs and HR leaders. - **Keep LMS rosters in sync with the employee directory** — Learning management systems can continuously sync employees, departments, and job roles from PeopleForce to auto-enroll new hires in mandatory training and remove departed employees — without any manual roster management. - **Enforce shift scheduling rules with live leave data** — Workforce management tools can reference PeopleForce time-off policies, approved leave requests, and employee locations to prevent scheduling conflicts and ensure compliance with statutory working-hour limits. ## What you can build - **Real-time org chart sync** — Automatically mirror PeopleForce's departments, divisions, and reporting structures into your product by syncing Employees, Groups, and Group Types through the Unified HRIS API. - **Automated role-based access control (RBAC) mapping** — Use Job Roles and Group data from PeopleForce to dynamically assign permissions and feature access inside your application whenever an employee's role changes. - **Leave-aware capacity calendar** — Pull Timeoff Requests, Timeoff Balances, and Timeoff Policies to build a visual capacity view that automatically blocks out employees on approved leave from project assignments. - **Compensation band dashboard** — Sync Employee Compensations and Locations to power internal pay equity analysis, budget forecasting, and market-rate comparison reports for HR leaders. - **One-click PeopleForce connect for end users** — Ship a branded integration setup flow where your customers authenticate their PeopleForce account through Truto's managed auth, with no API key wrangling or custom OAuth work on your side. - **Multi-location employee directory** — Combine Employees and Locations data to give your users a filterable, always-current workforce directory segmented by office, region, or country. ## FAQs ### How does authentication work for PeopleForce integrations through Truto? PeopleForce uses a Company API Key for full system-to-system access. Truto manages this credential securely so your end users simply provide their API key during the connection flow, and Truto handles storage, refresh, and request signing. ### What HRIS data models are available through Truto's Unified HRIS API for PeopleForce? The Unified HRIS API supports Employee Compensations, Employees, Fields, Group Types, Groups, Job Roles, Locations, Timeoff Balances, Timeoff Policies, Timeoff Requests, and Timeoff Types. ### Does PeopleForce support custom fields, and can I access them through Truto? Yes. The Unified HRIS API includes a Fields resource, which lets you read field metadata. Custom field values attached to employee records can be accessed alongside standard fields through the unified Employees model. ### Are there additional PeopleForce-specific tools or endpoints available beyond the Unified HRIS API? Currently, PeopleForce is supported through the Unified HRIS API. No additional PeopleForce-specific tools are available out of the box, but Truto builds custom tools on request if you need access to endpoints outside the unified model, such as ATS or performance data. ### How does Truto handle pagination and rate limits for PeopleForce? Truto abstracts away PeopleForce's pagination and rate-limiting behavior. You make standard requests to Truto's Unified API, and Truto handles cursor management, retries, and throttling automatically so you don't need to implement API-specific workarounds. ### Can I write data back to PeopleForce, or is it read-only? The available operations depend on what PeopleForce's API and Truto's Unified HRIS API support for each resource. Read operations are broadly available across all listed models. For write or update capabilities on specific resources, contact Truto to confirm current support or request it be built.