Factorial HR Component

Factorial HR Component connects your flow to your account in Factorial, the human resources tool. With a single component you can reach almost every area of Factorial: time off and holidays, attendance and shifts, recruiting, contracts, expenses, projects, documents and company settings.

It is useful to automate staff tasks that are done by hand today, such as recording an absence that arrives by email, preparing an attendance report, or adding a candidate who applied on your website.

When to use it

An employee asks for holidays by chat and you want to record the request in Factorial.
You want a weekly report with the team’s hours worked or absences.
Candidates apply through a form on your website and you want to add them to the recruiting process in Factorial.
An AI agent answers staff questions and needs to look up time-off policies or work schedules.

Configuration

You need a Factorial Task API credential with an API key from your Factorial account. See Credentials.

Field	What it does
Credential (required)	The Factorial Task API credential used to access your account.
Resource	The area of Factorial you work with. See Resources.
Operation	What you do in that area. The list changes with the chosen Resource.

When you choose the resource and the operation, the component shows only the fields that operation needs, with their name and a short help text. Required ones are marked in the editor.

Operations almost always follow the same pattern for each kind of data in the area: List all… (return all), Get… (return one by its ID), Create…, Update… and Delete…. For example, in Timeoff you will find List all leaves, Get leave, Create leave, Update leave and Delete leave for leave requests. The list only offers what Factorial’s API allows, so some kinds of data can only be looked up (for example expenses, job roles and levels, or employee updates).

Resources

Resource	What it manages
`Employees`	The employees: list them, look one up, create one with their contract, change their name, invite them to Factorial, and terminate or reinstate them. Creating and inviting ask for your company’s ID in Factorial, and terminating asks for the last day as `2026-10-31`.
`EmployeeUpdates`	Changes in each employee’s working life: new hires, terminations, absences, contract changes and personal data changes. Each `Get…` returns the changes of that kind for the given employee; Factorial records them itself, so they cannot be created here.
`Documents`	Document folders and their download links.
`Expenses`	Expenses, mileage and per diems.
`Companies`	The company’s legal entities.
`JobCatalog`	Job roles and levels.
`Contracts`	Compensations, contract templates and versions, and each country’s hiring data (contract types, professional categories, education levels, working-day types).
`Payroll`	Family situations, policy periods and payroll supplements.
`PayrollIntegrationsBase`	The codes that connect Factorial with your payroll software.
`PayrollEmployees`	Employees’ payroll identifiers.
`ATS`	Recruiting: job postings, candidates, applications, hiring stages, questions, evaluations, messages and rejection reasons.
`Locations`	Workplaces and their work areas.
`ProjectManagement`	Projects, subprojects, tasks and assigned people, and the time and expenses logged against them.
`Tasks`	Factorial tasks and their files.
`Posts`	Posts, groups and comments on the company feed.
`Finance`	Accounts, contacts, cost centers, financial documents, journal entries and taxes.
`Attendance`	Attendance: worked time, shifts, open shifts, overtime, edit requests and breaks.
`TimePlanning`	Shift planning and its breaks.
`WorkSchedule`	Work schedules and their per-day setup.
`ShiftManagement`	Shifts.
`TimeSettings`	Break settings.
`Timeoff`	Time off and holidays: requests, leave types, policies, available allowances and blocked periods.
`CustomFields`	The custom fields your company added in Factorial, their options and their values.
`Marketplace`	The settings of apps installed from the Factorial marketplace.

Output

The Response output returns Factorial’s answer as text: the details of the item you worked with, the list of items for the List all… operations, or a confirmation for those that delete.

You can connect the result to an agent so it can summarize or interpret it, or to a component that extracts the details you need. The component can also be connected to an Agent as a tool. See Tool Mode.

Example

A company wants holiday requests that arrive by email to be recorded in Factorial.

The email reaches the flow and an agent extracts the employee, the dates and the number of days.
Add Factorial HR Component with the Timeoff resource and the Create leave operation.
Fill in Employee ID, Leave Type ID (the “Holidays” type, which you can look up with List all leave types), and Start Date and End Date in the format 2026-07-01. Factorial works out the days from the dates.
Connect Response to an email component that confirms to the employee that the request is recorded.

Good practices

The IDs of employees, leave types, workplaces or projects are found with the List all… operations of the matching resource. Keep them so you don’t have to look them up on every run.
Try the operations that create, change or delete data on a test employee or record first.

Holded Team Component: employees and time tracking in Holded.