2026-01-01 Release Notes

Attendance > Shift

Shift operations

Request

New Field time_settings_break_configuration_id has been added Specific break configuration id when toggling the shift into a break and out of a break

Contracts > Contract version

Contracts contract version

Request

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Request

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Request

New Field job_catalog_tree_node_uuids has been added The uuid of nodes in the job catalog tree. as only level nodes are accepted and persisted, so filtering with other node types will return no results. refer to job_catalog/tree_nodes endpoint.

All Responses

New Field is_reference has been added Whether it is the reference contract today or not. it is important to remark that reference contract doesn't mean active

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Contracts > Contract version history

Contracts contract version history

All Responses

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Contracts > Reference contract

Contracts reference contract

Request

New Field job_catalog_tree_node_uuids has been added The uuid of nodes in the job catalog tree.

All Responses

New Field is_reference has been added Whether it is the reference contract today or not. it is important to remark that reference contract doesn't mean active

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

CustomFields > Value

Custom fields value

Request

New Field updated_at_gteq has been added Filter values updated on or after this date (iso 8601 format).

All Responses

New Field updated_at has been added The date and time the custom field value was last updated.

CustomResources > Value

Handles values for schemas (custom tables)

Request

New Field custom_resource_id has been added The identifier of the resource that owns the resource value

All Responses

Removed Field field_id has been removed

Removed Field long_text_value has been removed

Removed Field date_value has been removed

Removed Field text_value has been removed

Removed Field number_value has been removed

Removed Field option_value has been removed

Removed Field cents_value has been removed

Removed Field boolean_value has been removed

Removed Field single_choice_value has been removed

Removed Field multiple_choice_value has been removed

New Field resource_id has been added The identifier of the resource that owns the resource value

Employees > Employee

Employee

Request

New Field company_identifier has been added Filter by employee company identifier.

New Field updated_at_gteq has been added Filter employees updated on or after this timestamp (greater than or equal).

Request

New Field job_catalog_tree_node_uuid has been added The uuid of nodes in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

New Endpoint

Expenses > Expensable

Represents an expensable resource, which can be a regular expense or a mileage expense.

All Responses

New Field budget_id has been added The id of the budget

New Field project_id has been added The id of the project

New Field cost_center_ids has been added The ids of the cost centers

Expenses > Expense

Represents an expense

All Responses

New Field budget_id has been added The id of the budget associated with this expense

New Field project_id has been added The id of the project associated with this expense

New Field cost_center_ids has been added Array of cost center ids associated with this expense

Expenses > Mileage

Represents a mileage

All Responses

New Field budget_id has been added The id of the budget associated with this mileage

New Field project_id has been added The id of the project associated with this mileage

New Field cost_center_ids has been added Array of cost center ids associated with this mileage

Expenses > Per diem

Represents a per diem

All Responses

New Field budget_id has been added The id of the budget associated with this per diem

New Field project_id has been added The id of the project associated with this per diem

New Field cost_center_ids has been added Array of cost center ids associated with this per diem

Finance > Budget option

Budget with limited information for general viewing purposes (e.g. reporting an expense)

New Endpoint

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.

All Responses

New Field syncable_type has been added Type of the syncable item

ItManagement > It asset

IT Asset (device, accessory, keys, etc)

New Endpoint

New Endpoint

New Endpoint

New Endpoint

New Endpoint

ItManagement > It asset model

IT Asset Model (make/model of device)

New Endpoint

New Endpoint

New Endpoint

New Endpoint

JobCatalog > Node attribute

JobCatalog Node Attributes

New Endpoint

JobCatalog > Tree node

JobCatalog Tree Node

All Responses

New Field job_catalog_title has been added Full title that represents the job position.

New Endpoint

Posts > Group

Posts group

Request

New Field search has been added Search term to filter groups by title or description.

Procurement > Purchase order

purchase_order

New Endpoint

New Endpoint

Procurement > Purchase request

purchase_request

New Endpoint

New Endpoint

Procurement > Type

type of purchase (e.g. software, training, etc.)

New Endpoint

New Endpoint

ProjectManagement > Planned record

Project management planned records

New Endpoint

New Endpoint

New Endpoint

New Endpoint

ProjectManagement > Project

Project Management Projects

Request

New Field legal_entity_id has been added Id of the legal entity for the currency of the project

ProjectManagement > Subproject

Project Management Subprojects

All Responses

New Field description has been added The description of the subproject

New Field status has been added The status of the subproject

New Field code has been added The code of the subproject

New Field start_date has been added The start date of the subproject

New Field due_date has been added The due date of the subproject

New Field is_billable has been added Whether the subproject is billable

New Endpoint

Tasks > Task

Factorial task element

Request

New Field category has been added Filter by tasks that have a specific category

Timeoff > Leave

Timeoff leave

Request

New Field approved has been added Whether the leave is approved

New Field skip_notifications has been added Whether to skip notifications for this update

New Field skip_validations has been added Whether to skip validations for this update

New Field skip_medical_leave has been added Whether to skip medical leave processing for this update

Request

New Field type_is_payable has been added Retrieve payable leaves

All Responses

New Field days_taken has been added Number of days taken for paid leave

Trainings > Training

Trainings

Request

New Field is_mandatory has been added This field is used to filter by mandatory or non-mandatory trainings if provided

New Field with_current_training_classes has been added This field is used to filter those trainings whose have current training classes if 'true'

Request

New Field thumbnail has been added The training thumbnail

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Request

New Field thumbnail has been added

All Responses

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Trainings > Training class

Training classes

All Responses

New Field completed_attendances_count has been added Number of completed session attendances in this group.

New Field total_attendances_count has been added Total number of session attendances expected in this group.

Webhooks

Payloads

New Field is_reference has been added Whether it is the reference contract today or not. it is important to remark that reference contract doesn't mean active

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Payloads

New Field is_reference has been added Whether it is the reference contract today or not. it is important to remark that reference contract doesn't mean active

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Payloads

New Field is_reference has been added Whether it is the reference contract today or not. it is important to remark that reference contract doesn't mean active

New Field job_catalog_tree_node_uuid has been added The uuid node in the job catalog tree. for now it only supports level nodes. from this point in the job catalog tree you can get the full ancestor path to the root node including the role. refer to job_catalog/tree_nodes endpoint.

Payloads

New Field budget_id has been added The id of the budget

New Field project_id has been added The id of the project

New Field cost_center_ids has been added The ids of the cost centers

Payloads

New Field days_taken has been added Number of days taken for paid leave

Payloads

New Field days_taken has been added Number of days taken for paid leave

Payloads

New Field days_taken has been added Number of days taken for paid leave

Payloads

New Field days_taken has been added Number of days taken for paid leave

Payloads

New Field days_taken has been added Number of days taken for paid leave

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course

Payloads

New Field thumbnail has been added

New Field is_mandatory has been added This field is used to define if the training is mandatory or not

New Field total_duration has been added The total duration in hours and minutes of the course