Create with contracts an Employee

post

https://api.factorialhr.com/api/2025-10-01/resources/employees/employees/create_with_contract

Create an employee with a contract

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

company_id

integer

required

company id of the employee, you can get it in companies/legal_entities endpoint.

first_name

string

required

name of the employee.

last_name

string

required

last name of the employee.

string

required

personal email of the employee.

contract_effective_on

string

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

contract_starts_on

string

the day the employee is hired.

ends_on

string

the day the contract ends.

gender

string

gender of the employee (male | female).

identifier

string

national identifier number.

identifier_type

string

type of identifier (ex passport).

identifier_expiration_date

string

identifier expiration date.

birthday_on

string

birthday of the employee.

nationality

string

nationality country code of the employee (Spain ES, United Kingdom GB).

address_line1

string

address of the employee.

address_line_2

string

address of the employee.

postal_code

string

postal code of the employee.

city

string

city of the employee.

state

string

state/province/region of the employee.

country

string

country code of the employee (Spain ES, United Kingdom GB).

bank_number

string

bank account number of the employee.

swift_bic

string

code to identify banks and financial institutions globally.

manager_id

integer

id of manager, you can get the manager_id from employees endpoint.

timeoff_manager_id

integer

id of manager, you can get the manager_id from employees endpoint.

legal_entity_id

integer

legal entity of the employee, references to companies/legal_entities.

company_identifier

string

identity number or string used inside a company to internally identify the employee.

seniority_calculation_date

string

date since when the employee is working in the company.

team_id

integer

team id of the employee.

location_id

integer

location id of the employee, references to locations/locations.

social_security_number

string

social security number of the employee.

has_trial_period

boolean

does the employee have a trial period?

trial_period_ends_on

string

when the trial period ends.

contact_name

string

name of the emergency contact.

contact_number

string

phone number of the emergency contact.

phone_number

string

phone number of the employee.

a3_innuva_code

string

A3Innuva employee code.

a3_nom_code

string

A3Nom employee code.

contracts_bank_holiday_treatment

string

enum

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

Allowed:

contracts_annual_working_time_distribution

string

enum

the annual working time distribution of the employee.

Allowed:

contracts_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).

contracts_max_legal_yearly_hours

integer

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

contracts_maximum_weekly_hours

integer

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

Response

200OK