---
title: "Creates a Leave"
method: POST
path: "/api/2026-07-01/resources/timeoff/leaves"
tags: ["Timeoff > Leave"]
---

# Creates a Leave

`POST /api/2026-07-01/resources/timeoff/leaves`

Creates a Leave

## Request body

- object
  - `employee_id` string, required — The employee id of the leave
  - `leave_type_id` string — 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` string — 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 `201`

CREATED

- TimeoffLeave
  - `id` string, required — Identifier of the Leave
  - `company_id` string, required — Company identifier of the employee of the leave
  - `employee_id` string, required — Employee identifier of the leave
  - `start_on` string, required — The start date of the leave
  - `finish_on` string — The end date of the leave
  - `half_day` string — Indicates if the leave is taken as a half-day
  - `description` string — A description of the leave
  - `reason` string — The reason provided by the employee for taking the leave
  - `leave_type_id` string — The identifier for the type of leave
  - `leave_type_name` string — The name of the leave type
  - `approved` boolean — Indicates whether the leave has been approved
  - `employee_full_name` string — The full name of the employee taking the leave
  - `start_time` string — The start time of the leave
  - `hours_amount_in_cents` integer — The total number of hours taken for the leave, represented in cents
  - `updated_at` string, required — The updated at date of the leave
  - `created_at` string — The created at date of the leave
  - `deleted_at` string — The date when the leave was deleted
  - `duration_attributes` string — The duration attributes of the leave
  - `days_taken` number, required — Number of days taken for paid leave

---

[API](https://skmtc.net/factorialhr/apis/factorial-api.md) · [All operations](https://skmtc.net/factorialhr/apis/factorial-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/factorialhr/factorial-api/versions/1a6bffb20f7d/schema)