We are excited to introduce v2025-10-01 (Dirichlet)
of our API! This version continues our commitment to evolving the platform without introducing breaking changes, offering new capabilities and enhancements across key business areas.
Inspired by the Dirichlet series—known for their rigor and role as a bridge toward deeper mathematical insights—this update strengthens and extends the API’s functionality, providing your integrations with more precision, control, and reliability.
This release introduces impactful additions across Attendance, Banking, Contracts, Custom Resources, Expenses, Finance, Performance, Project Management, Shift Management, Time Off, Trainings, and Webhooks. You’ll find powerful new endpoints, expanded request and response fields, and enriched payloads designed to make your automation and reporting more complete and adaptable.
Some highlights include:
Attendance Reviews → new endpoints for bulk create, bulk destroy, and list reviews, plus the new id field in responses.
Bank Accounts → new field bank_account_membership_employee_ids and removal of bank_account_membership_access_ids.
Contracts → expanded support with new fields like job_catalog_role_id and archived filters across French, German, and Portuguese contract types.
Custom Resources → new endpoints and fields such as attachable_id for more flexible resource handling.
Expenses → bulk set-to-paid endpoint for expensables.
Finance → richer Contact data, now including email, website, and phone_number in create, update, read, and responses.
Performance → new endpoints for evaluation scores, updated filters (reviewer_strategies), and field removals for clarity.
Project Management → include_costs option when reading projects.
Shift Management → bulk create with new planned_breaks field.
Time Off → new duration_attributes field for leaves, also reflected in webhook payloads.
Trainings → session endpoints enhanced with the active filter.
Webhooks → enriched payloads for Contracts (Contract Versions) and Time Off (Leaves), including new job_catalog_role_id and duration_attributes fields.
Check out the full Changelog to explore every new feature and improvement.
We’d love to hear how these updates help you build smarter, faster, and more scalable integrations!
New Field location_ids has been added
Location ids
Removed Field location_id has been removed
New Field team_ids has been added
Team ids
Removed Field team_id has been removed
New Field employee_ids has been added
Filter by the default location of these employees
Integrations > Syncable item
Integrations SyncableItem represents the item data that needs to be synced within a SyncRun. A SyncRun represents each synchronization execution of a set of items. This endpoint is designed to be used by integrators building a integration between Factorial and an external systems.
Integrations SyncableSyncRun represents a synchronization execution of a SyncableItem within a sync run. A sync run represents each synchronization execution of a set of items. This endpoint is designed to be used by integrators building a integration between Factorial and an external systems.
New Field include_costs has been added
If true we will perform the costs calculations and will be return the total cost. if false, 0 will be returned and no costs calculations will be performed.
New Field client_ids has been added
Retrieve only the projects that are related to the clients passed in the request, refers to finance/contacts.
We are excited to introduce v2025-07-01 (Laurent) of our API! This version continues our commitment to evolving the platform without introducing breaking changes, offering new capabilities and enhancements across key business areas.
Inspired by the Laurent series—which extends Taylor series to represent functions more flexibly—this update broadens and deepens the API’s functionality, giving your integrations greater range and precision.
This release brings impactful additions to Performance, Contracts, and Trainings, along with updates to Attendance, Finance, Employees, ATS, Banking, and more. You’ll find powerful new endpoints, expanded request and response fields, and enriched webhook payloads designed to make your automation and reporting more complete and adaptable.
Some highlights include:
New endpoints for Contract Versions, Spanish Working Day Types, Training Classes, and Banking Transactions.
Richer Employee data, including birthplace, country of birth, and attendance eligibility.
Advanced Performance Review configurations, with simplified payloads and custom templates.
Greater control in Time Planning, ATS, and Project Management, with new filters, fields, and scheduling options.
Extended Financial data fields, enhancing the traceability of documents and cost centers.
Check out the full Changelog to explore every new feature and improvement.
We’d love to hear how these updates help you build smarter, faster, and more scalable integrations!
We are excited to introduce v2025-04-01 (Taylor) of our API! This version brings a wide range of enhancements, making our API more powerful and adaptable without breaking changes.
Just like the Taylor series approximates complex functions by breaking them down into simpler polynomial terms, this API update refines and extends existing functionalities, making your integrations more precise and efficient with incremental but impactful changes.
The most significant enhancements focus on Contracts, Finance, and Employee endpoints and webhooks, while other key areas, including ATS, Attendance, Banking, Performance, and Project Management, also benefit from new endpoints and expanded field options.
Check out the full Changelog for a deeper dive into all the new features and enhancements.
Let us know how you leverage these updates to improve your processes!
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
All Responses
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
Contracts > Reference contract
Contracts reference contract
All Responses
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
New Field schedule has been added Scheduled or self paced. scheduled needs to have a start time and end time within the same day, self paced can start and end in different days and specific time won't be shown in the frontend app.
New Field schedule has been added Scheduled or self paced. scheduled needs to have a start time and end time within the same day, self paced can start and end in different days and specific time won't be shown in the frontend app.
All Responses
Removed Field session_attendances_status has been removed
New Field schedule has been added Session schedule information (scheduled, self-paced)
New Field parent_id has been added Id of the recurrent session that is parent of the current one
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
New Field annual_working_time_distribution has been added Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.
Estimated time is used in attendance to know how many time is planned for employee/date to work. From this resource we get the original planned time, how this time has been affected by bank holidays and leaves and the planned shifts and breaks in case there are.
All Responses
New Field id has been added Id to specify the estimation time it includes the employee_id and date
Banking > Bank account
Bank Account represent a bank account that can be used to perform transactions, review balances and more.
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
All Responses
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
Contracts > Reference contract
All Responses
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field seniority_calculation_date has been added Date since when the employee is working in the company.
New Field contracts_bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field contracts_working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field contracts_max_legal_yearly_hours has been added The maximum amount of hours the employee can work in a year.
New Field contracts_maximum_weekly_hours has been added The maximum amount of hours the employee can work in a week.
All Responses
New Field termination_type_description has been added The description of the termination type.
New Field termination_reason_type has been added Termination reason type of the employee
New Field seniority_calculation_date has been added Date since when the employee is working in the company.
Expenses > Expensable
Represents an expensable resource, which can be a regular expense or a mileage expense.
All Responses
New Field internal_reference has been added The optional internal reference of the expensable
Finance > Account
Ledger account refers to a structured entity that represents an account within a general ledger system.
Ledger account resource refers to a structured entity that represents an account within a general ledger system. It serves as a digital record for tracking financial transactions related to a specific category. (e.g. bank account, vendor, tax type, expense, etc.)
New Field employee_potential_score_enabled has been added Include one question at the end of the review to rate participants' potential. this rating will be reflected in the 9 box grid.
Performance > Review questionnaire by strategy
Performance Review Questionnaire by reviewer strategies
All Responses
New Field employee_potential_score_manager_questionnaire has been added Questionnaire included in the end of manager evaluation to evaluate the employee potential
ProjectManagement > Exportable project
Project Management Exportable Projects
All Responses
New Field client_id has been added The client id of the project
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
New Field min_rest_minutes_between_days has been added The minimum amount of minutes the employee must rest between working periods.
New Field max_work_minutes_per_day has been added The maximum amount of minutes the employee can work in a day.
New Field max_work_days_in_row has been added The maximum amount of days the employee can work in a row.
New Field min_rest_hours_in_row has been added The minimum amount of hours the employee must rest in a row.
New Field bank_holiday_treatment has been added Defines whether a bank holiday should be considered as a workable or non-workable day.
New Field working_time_percentage_in_cents has been added Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).
We are happy to announce the new v2025-01-01 (Fourier) version has been released. Most of the API remains the same, with updated endpoint paths.
As you know, our versions are named after famous numeric series. The Fourier series is renowned for breaking down complex patterns into simple, steady components. Similarly, this release reflects our commitment to clarity and dependability, ensuring our endpoints work seamlessly and reliably.
The most relevant parts are Performance endpoints and webhooks . Other additions are contract type endpoints and improvements in Ats, Attendance, Employees, Expenses, Teams, and Project Management resources.
Don't miss out on the news it brings and read the detailed Changelog
New Field competencies_assessments_enabled has been added Whether the competencies assessments are enabled or not. this will allow assessing competencies for self and manager evaluations
All Responses
New Field competencies_assessments_configuration has been added Configuration of the competencies assessments feature
Represents a specific time frame where a schedule applies. It has a day and month for for beginning and end, but not a year: it is assumed it repeats every year at the same dates.
As you know, our versions are named as famous numeric series. In mathematics, the Fibonacci sequence is a sequence in which each number is the sum of the two preceding ones.
The Fibonacci series has rapid growth, just like this version, which includes, among other things, the following changes:
The most relevant parts are Performance endpoints and webhooks , which are new in this version. Other additions are workplace information in EmployeeUpdates, Shift name information in ShiftManagement, as well as other improvements in Attendance, Expenses, Training, Tasks, and Project Management resources.
Don't miss out on the news it brings and read the detailed Changelog
In these last quarter, we have driven the Factorial's public API to first class. We have set the foundations for a fully stable and versioned public API. This means we have set the following changes:
Stabilizing version v2
V2 version has been in the oven for several months. Last July, we started to publish in v2 everything missing from v1. All the functionality in v1 must be now available in v2. If this is not the case, please contact us and let us know
We finally released v2 version at the beginning of September, deprecating v1 version
Versioned v2: 2024-10-01 and next
But we didn't stop here. Factorial's product teams move fast. They are constantly improving to deliver value to our clients. And the public API improves with them. Many of the new features are exposed to the public API, so our clients and developer partners can use them and bring more value to our users.
On the other hand, we know that public API consumers have their own pace. Keeping up to date with Factorial's API changes is probably not the first thing on their ToDO list.
This is why we are introducing API versioning in our v2 public API version. Every quarter, we are evolving our v2 version to new releases, without losing backwards compatibility within a year. This way, we give our API consumers enough time to adapt to new changes, while our product teams evolve fast.
Upgrading to newer versions should be must easy, just changing the paths most of the time. We will be publishing a detailed changelog, like 2024-10-01 Release Notes so clients and partners are able to easily upgrade.
Deprecating v1
Our v1 version has served us well for years, but it has several flaws and we need to move on. V1 version will keep working until April 1st, 2025. Afterward, it will be removed. Working webhooks will be automatically migrated to v2.
