We are happy to announce the new v2024-10-01 (Fibonacci) version has been released. This is the first versioned release of the v2 API. Most of the API remains the same, with updated endpoint paths.

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.

Attendance > Open shift

Reads all Open shifts

Request

• Field employee_id type has been changed to Integer Array
• Field employee_id has been renamed to employee_ids

EmployeeUpdates > New hire

Response

• Field workplace_id added

EmployeeUpdates > Personal change

Response

• Field workplace_id added

Expenses > Expensable

Reads a single Expensable

Request

• Field group_id type has been changed to Integer Array
• Field group_id has been renamed to group_ids

Response

• Field per_diem added

Expenses > Mileage

Response

• Field round_trip added

Performance > Agreement

Reads all Agreements

• Endpoint added

Reads a single Agreement

• Endpoint added

Bulk Initiates an Agreement

• Endpoint added

Initiates an Agreement

• Endpoint added

Performance > Review Evaluation

Reads all Review Evaluations

• Endpoint added

Reads a single Review Evaluation

• Endpoint added

Replace reviewers a Review evaluation

• Endpoint added

Performance > Review Evaluations Answer

Reads all Review Evaluations Answer

• Endpoint added

Performance > Review Owner

Reads all Review Owner

• Endpoint added

Deletes a Review Owner

• Endpoint added

Bulk creates a Review Owner

• Endpoint added

Performance > Review Processes

Reads all Review processes

• Endpoint added

Reads a single Review process

• Endpoint added

Creates a Review process

• Endpoint added

Deletes a Review process

• Endpoint added

Duplicates a Review process

• Endpoint added

Remind in bulks a Review process

• Endpoint added

Reopens a Review process

• Endpoint added

Starts a Review process

• Endpoint added

Stops a Review process

• Endpoint added

Toggle archives a Review process

• Endpoint added

Update agreements configurations a Review process

• Endpoint added

Update basic infos a Review process

• Endpoint added

Update deadlines a Review process

• Endpoint added

Update reviewer strategies a Review process

• Endpoint added

Update schedules a Review process

• Endpoint added

Update target strategies a Review process

• Endpoint added

Performance > Review Process Estimated Targets

Reads all Review process estimated targets

• Endpoint added

Performance > Review Process Targets

Reads all Review process targets

• Endpoint added

Reads a single Review process targets

• Endpoint added

Deletes a Review process targets

• Endpoint added

Add peers a Review process target

• Endpoint added

Bulk creates a Review process target

• Endpoint added

Remove peer evaluations a Review process target

• Endpoint added

Performance > Review Questionnaire By Strategies

Reads all Review questionnaire by strategies

• Endpoint added

Reads a single Review questionnaire by strategies

• Endpoint added

Update default rating scales a Review questionnaire by strategies

• Endpoint added

Update questionnaire for strategies a Review questionnaire by strategies

• Endpoint added

Performance > Review Visibility Setting

Reads all Agreements

• Endpoint added

Updates a Review visibility setting

• Endpoint added

ProjectManagement > Project

Response

• Field client_id added

ProjectManagement > Project worker

Response

• Field labor_cost_currency has been removed

ShiftManagement > Shift

Reads a single Shift

Request

• Field name has been added

Response

• Field name added

Tasks > Task

Reads a single Task

Request

• Field involvee_id has been added

Timeoff > Allowance stat

Reads a single Allowance stat

Request

• Field reference_date is now mandatory

Trainings > Training

Creates a Training

Request

• Field objectives has been added

Response

• Field objectives added
• Field number_of_expired_participants added

Trainings > Training membership

Response

• Field training_completion_date has been renamed to training_completed_at

Webhooks

Performance > ReviewProcess > Creates

• New webhook

Performance > ReviewProcess > Deletes

• New webhook

Performance > ReviewProcess > Duplicates

• New webhook

Performance > ReviewProcess > Remind in bulks

• New webhook

Performance > ReviewProcess > Reopens

• New webhook

Performance > ReviewProcess > Starts

• New webhook

Performance > ReviewProcess > Stops

• New webhook

Performance > ReviewProcess > Toggle archives

• New webhook

Performance > ReviewProcess > Update agreements configurations

• New webhook

Performance > ReviewProcess > Update basic infos

• New webhook

Performance > ReviewProcess > Update schedules

• New webhook

Performance > ReviewProcess > Update target strategies

• New webhook

Performance > ReviewProcess > Starts

• New webhook

Since today, we have enabled webhooks to subscribe to events that take place in Factorial. You can check the webhooks API documentation here.

Right now we just have a trigger, which calls you when an employee is invited to your company.

Be sure to check this documentation since we plan to launch more webhooks in the near future!

Welcome to the developer hub and documentation for factorial! We just launched the first version of our public API.

The Factorial API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs.

Make sure to regularly check the changelog, as we will be continuously improving the Factorial API, always keeping in mind retro compatibility through versioning.

To start using the API head over to our Getting Started guide.