Skip to content

HRIS

Factorial
API integration

Ship HRIS features without building the integration. Full Factorial API access via Proxy, normalized data through Unified APIs — extend models and mappings to fit your product.

Talk to us
Factorial

Use Cases

Why integrate with Factorial

Common scenarios for SaaS companies building Factorial integrations for their customers.

01

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.

02

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.

03

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.

04

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.

05

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

Ship these features with Truto + Factorial

Concrete product features your team can ship faster by leveraging Truto’s Factorial integration instead of building from scratch.

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

Unified APIs

Unified APIs for Factorial

Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.

Unified HRIS API

Employee Compensations

Represent the compensation configuration for an Employee

View Docs

Employees

Represents an employee in HRIS

View Docs

Employments

Employments represent a job position at a company.

View Docs

Fields

Represent the fields for various entities in the company

View Docs

Groups

Groups represent the groups for an Employee

View Docs

Locations

Locations represent the locations in HRIS

View Docs

Timeoff Policies

Represent the time off policies in a company

View Docs

Timeoff Requests

Represent the time off requests for an Employee

View Docs

Timeoff Types

Represent the time off types in a company

View Docs

How It Works

From zero to integrated

Go live with Factorial in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Factorial account

Use Truto’s frontend SDK to connect your customer’s Factorial account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Factorial

Truto’s Proxy API is a 1-to-1 mapping of the Factorial API. You call us, we call Factorial, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Factorial’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Factorial on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

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.

Factorial

Get Factorial integrated into your app

Our team understands what it takes to make a Factorial integration successful. A short, crisp 30 minute call with folks who understand the problem.

Talk to us