Creates a Contract version

post

https://api.factorialhr.com/api/2025-10-01/resources/contracts/contract_versions

Body Params

employee_id

integer

required

employee identifier, refers to /employees/employees endpoint.

effective_on

string

required

the day the specific contract starts, in case of hiring the same than starts_on.

starts_on

string

required

the day the employee is hired.

ends_on

string

the day the employee is terminated.

working_hours_frequency

string

the frequency of the working hours.

working_week_days

string

the days of the week the employee works.

working_hours

integer

the amount of hours the employee works.

max_legal_yearly_hours

integer

the maximum amount of hours the employee can work in a year.

maximum_weekly_hours

integer

the maximum amount of hours the employee can work in a week.

min_rest_minutes_between_days

integer

the minimum amount of minutes the employee must rest between working periods.

max_work_minutes_per_day

integer

the maximum amount of minutes the employee can work in a day.

max_work_days_in_row

integer

the maximum amount of days the employee can work in a row.

min_rest_hours_in_row

integer

the minimum amount of hours the employee must rest in a row.

salary_frequency

string

the frequency of the salary payment. When adding a salary to a contract that previously had none, both salary_amount and salary_frequency must be provided together.

salary_amount

integer

the amount of money the employee earns in cents.

job_title

string

job title of the employee.

has_trial_period

boolean

a flag that indicates if the employee has a trial period.

trial_period_ends_on

string

when the trial period ends.

working_time_percentage_in_cents

integer

Working time percentage in cents (e.g., when an employee is working part-time, the percentage of full-time hours they are working).

annual_working_time_distribution

string

enum

Allows companies to define how annual working hours are spread across the year to ensure compliance with legal limits.

Allowed:

copy_current_contract_version

boolean

wether to copy the current contract version.

job_catalog_level_id

integer

the id of the job catalog level.

bank_holiday_treatment

string

enum

Defines whether a bank holiday should be considered as a workable or non-workable day.

Allowed:

Response

201CREATED