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

Creates a Leave

post

https://api.factorialhr.com/api/2025-07-01/resources/timeoff/leaves

Creates a Leave

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

employee_id

integer

required

The employee id of the leave

leave_type_id

integer

The leave type id

description

string

The description of the leave

start_on

string

required

The valid start date of the leave following the format YYYY-MM-DD

finish_on

string

The valid end date of the leave following the format YYYY-MM-DD

half_day

string

If the leave is in: [beggining_of_day, end_of_day]

start_time

string

The start time of a leave

hours_amount_in_cents

integer

The hours amount in cents of a leave

medical_leave_type

integer

The medical leave type

effective_on

string

The effective on date of a leave following the format YYYY-MM-DD

medical_discharge_reason

string

The medical discharge reason of a leave

colegiate_number

integer

The colegiate number of a leave

has_previous_relapse

boolean

If the leave has previous relapse

relapse_leave_id

integer

The leave relapse id

relapse_on

string

The leave relapse on date following the format YYYY-MM-DD

accident_on

string

The leave accident on date following the format YYYY-MM-DD

paternity_birth_on

string

The leave paternity birth on date following the format YYYY-MM-DD

Response

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201CREATED