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

Creates a Leave type

post

https://api.factorialhr.com/api/2025-10-01/resources/timeoff/leave_types

Body Params

accrues

boolean

required

Whether the leave type accrues over time

approval_required

boolean

required

Whether approval is required for this leave type

identifier

string

required

A unique identifier for the leave type

attachment

boolean

Whether an attachment is required for this leave type

color

string

required

The color associated with this leave type

name

string

required

The name of the leave type

visibility

boolean

Whether the leave type is visible to employees

workable

boolean

required

Whether the leave type is workable (can be worked on during leave)

payable

boolean

Whether the leave type is payable

is_attachment_mandatory

boolean

Whether the attachment is mandatory

half_days_units_enabled

boolean

Whether half-day units are enabled for this leave type

max_days_in_cents

integer

Maximum days in cents that can be taken

min_days_in_cents

integer

Minimum days in cents that must be taken

company_id

integer

required

Identifier of the company associated with this leave type

editable

boolean

Whether the leave type is editable

allow_endless

boolean

Whether endless leave is allowed

restricted

boolean

Whether the leave type is restricted

description

string

Description of the leave type

details_required

boolean

required

Whether additional details are required for the leave type

Response

Language

Credentials

URL

Response

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

application/json

201CREATED