--- title: Factorial API Integration on Truto slug: factorial category: HRIS canonical: "https://truto.one/integrations/detail/factorial/" --- # Factorial API Integration on Truto **Category:** HRIS **Status:** Generally available ## Unified APIs ### Unified HRIS API - **Employee Compensations** — Represent the compensation configuration for an Employee - **Employees** — Represents an employee in HRIS - **Employments** — Employments represent a job position at a company. - **Fields** — Represent the fields for various entities in the company - **Groups** — Groups represent the groups for an Employee - **Locations** — Locations represent the locations in HRIS - **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 Factorial 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 Factorial.** The Proxy API is a 1-to-1 mapping of the Factorial 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 rosters for automated provisioning** — SaaS companies offering IT management or identity tools can read Employees, Employments, and Groups from Factorial to automatically provision or deprovision software licenses, email accounts, and access permissions when staff join, change roles, or leave. - **Pull time-off data into resource planning tools** — Project management and workforce planning platforms can read Timeoff Requests, Timeoff Types, and Timeoff Policies from Factorial to automatically reflect approved leave on capacity plans — preventing managers from scheduling work for unavailable team members. - **Feed compensation data into benchmarking and equity platforms** — Compensation analytics and equity management tools can read Employee Compensations alongside Employees and Employments to keep salary bands, pay periods, and vesting schedules accurate without manual CSV imports from HR. - **Automate onboarding workflows in engagement and rewards platforms** — Employee engagement tools can read new Employees, their Groups, and Locations from Factorial to instantly create profiles, assign localized benefits budgets, and add new hires to the right department channels on day one. - **Map org structure into spend management and approval workflows** — Corporate card and expense platforms can read Employees, Employments, and Groups to dynamically set spending limits and approval chains based on job title, seniority level, and department as recorded in Factorial. ## What you can build - **Real-time org chart sync** — Automatically mirror Factorial's employee hierarchy — including departments, teams, locations, and reporting lines — into your product using the Employees, Groups, and Locations unified models. - **Automated new-hire detection and onboarding trigger** — Detect newly created Employees and their Employments in Factorial to kick off downstream provisioning, welcome flows, or benefits enrollment in your app. - **Leave-aware capacity planning** — Read Timeoff Requests and Timeoff Policies to block out employee availability on project timelines or shift schedules whenever PTO or sick leave is approved. - **Compensation change alerts** — Monitor Employee Compensations for pay rate or pay period updates and surface them as events in your compensation benchmarking, payroll, or financial forecasting product. - **Department-based permission mapping** — Use Groups and Locations data to auto-assign users to the correct permission sets, cost centers, or approval workflows inside your application. - **Termination-driven offboarding automation** — Detect employee status changes and termination dates from Employees and Employments to automatically revoke access, recover assets, or trigger exit surveys. ## FAQs ### What authentication method does Factorial use? Factorial uses OAuth 2.0 for authentication. Truto handles the full OAuth flow — including token refresh — so your end users simply authorize the connection and you never manage credentials directly. ### Which Factorial data models are available through Truto's Unified HRIS API? The Unified HRIS API exposes Employee Compensations, Employees, Employments, Fields, Groups, Locations, Timeoff Policies, Timeoff Requests, and Timeoff Types. These cover core workforce data including org structure, leave, and compensation. ### Does Truto support custom fields from Factorial? Yes. The Fields unified model lets you read custom field definitions from Factorial, so you can surface and map customer-specific HR data that goes beyond standard employee attributes. ### Are there additional Factorial-specific tools or proxy API endpoints available? Currently there are no pre-built Factorial-specific tools beyond the Unified HRIS API models. However, Truto builds additional tools on request — if you need access to Factorial endpoints not yet covered, reach out and the team will scope it. ### How does Truto handle Factorial API pagination and rate limits? Truto manages pagination and rate-limit handling internally. Your application makes standard requests against the Unified HRIS API and Truto takes care of paginating through Factorial's responses and respecting its rate limits so you don't have to. ### What regions and company sizes does Factorial typically cover? Factorial is most popular with SMEs of 20–500 employees, especially across Europe (Spain, UK, France, Germany, Italy) and increasingly in LATAM, Brazil, and the US. If your customers serve that market, a Factorial integration is high-value.