These docs are for v2026-01-01. Click to read the latest docs for v2026-04-01.

2026-07-01 Release Notes

Ats > Application

An application for a job in the ATS

All Responses

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

New Endpoint

Banking > Transaction

A banking transaction represents a movement of money between accounts.

Request

Modified Field account_ids has been renamed to bank_account_ids An array of factorial banking bank account ids to filter by.

Contracts > Contract version

Contracts contract version

All Responses

New Field version_data has been added Country-specific contract data (template fragments and fields).

Contracts > Materialized template

Materialized templates are country-specific contract template definitions materialized per company, country, and legal entity. They store the template structure as JSON including fields and their options.

New Endpoint

Contracts > Reference contract

Contracts reference contract

All Responses

New Field version_data has been added Country-specific contract data (template fragments and fields).

Employees > Employee

An employee of the company — their identity, organisational placement (manager, teams, location, legal entity) and lifecycle (active, terminating, terminated). The central record the rest of the HR data hangs off.

Request

New Field open_backfill has been added When true, automatically opens a backfill position (vacancy or requisition) for the terminated employee. requires ats to be enabled with an automatic backfill setting configured. when false or omitted, no backfill is created.

Request

New Field communications_email has been added Email address for company communications and notifications. separate from login email.

All Responses

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Expenses > Expensable

Represents an expensable resource — the header record every employee expense submission goes through, regardless of kind. It can be a regular (receipt-backed) expense, a mileage claim, or a per-diem allowance; the type field discriminates, and the matching detail record carries the kind-specific data.

New Endpoint

Integrations > Sync run output

Integrations SyncRunOutput represents the output file produced by a sync run (e.g. a CSV export). This endpoint is designed to be used by integrators building an integration between Factorial and an external system through the Factorial Integration Framework.

New Endpoint

Procurement > Purchase order

purchase_order

Request

Modified Field vendor_id type has been changed to list of numbers and renamed to vendor_ids Vendor ids to filter by.

ProjectManagement > Flexible time record

Project Management Flexible Time Records

Removed Endpoint

Removed Endpoint

Removed Endpoint

Removed Endpoint

ProjectManagement > Flexible time record comment

Project Management Flexible Time Record Comments

Removed Endpoint

Removed Endpoint

Removed Endpoint

Removed Endpoint

ProjectManagement > Time record

Project Management Time Records

All Responses

New Field observations has been added Comment for the time record

ShiftManagement > Shift

Retrieves and manages scheduled work shifts for employees. Shifts represent planned work periods with start and end times, assigned to specific employees at locations. Supports filtering by employees, locations, date ranges, and shift states (draft, published, backup).

Request

New Field destroy_backup_shifts has been added Also destroys shifts with status backup when true, which by default are being kept

Timeoff > Allowance stat

Timeoff allowance stat

All Responses

New Field cycle_carry_overs has been added Carry over entries between cycles, typed as an array of cyclecarryover value objects.

Removed Field carry_overs has been removed

Timeoff > Leave type

Timeoff leave type

Request

New Field eau_eligible has been added

Request

New Field eau_eligible has been added

All Responses

New Field eau_eligible has been added

Trainings > Training

Trainings

All Responses

New Field author_employee_id has been added Employee identifier of the training author

Webhooks

Payloads

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

Payloads

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

Payloads

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

Payloads

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

Payloads

New Field cv has been added Cv file attachment of the application (includes filename, url, byte_size, content_type, created_at)

Payloads

New Field version_data has been added Country-specific contract data (template fragments and fields).

Payloads

New Field version_data has been added Country-specific contract data (template fragments and fields).

Payloads

New Field version_data has been added Country-specific contract data (template fragments and fields).

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field communications_email has been added Confirmed email address for company communications and notifications. separate from login email, used for internal company announcements.

New Field unconfirmed_communications_email has been added Unconfirmed communications email address for the employee.

Payloads

New Field eau_eligible has been added

Payloads

New Field eau_eligible has been added

Payloads

New Field author_employee_id has been added Employee identifier of the training author

Payloads

New Field author_employee_id has been added Employee identifier of the training author

Payloads

New Field author_employee_id has been added Employee identifier of the training author

Payloads

New Field author_employee_id has been added Employee identifier of the training author

Payloads

New Field author_employee_id has been added Employee identifier of the training author

Payloads

New Field author_employee_id has been added Employee identifier of the training author