---
title: "POST Leave type"
method: POST
path: "/leave-types?access_token={{token}}"
---

# POST Leave type

`POST /leave-types?access_token={{token}}`

## Request

- Base URL: `https://www.humanity.com/api/v2`
- URL: `https://www.humanity.com/api/v2/leave-types?access_token={{token}}`
- Auth: API key in query parameter `access_token`

Permission Level: 5

## Request body `application/x-www-form-urlencoded`

- object
  - `max_num_at_once` integer: Limits maximum number of staff that can be booked at once
  - `days_booked_in_advanc` integer: Sets how many days the leave has to be booked in advance
  - `allow_hourly` integer: Can be 0 and 1 - if set to 0 this leave type can only have full day request, if set to 1 it will allow hourly leave requests
  - `entitled` integer: Maximum number of days for this leave type
  - `title` string: Title of the leave type
  - `description` string: Leave type description

## Response `200`

200

- object
  - `status` integer
  - `data` object
    - `id` string
    - `name` string
    - `description` string
    - `allow_hourly` string
    - `max_num_of_staff_at_once` integer
    - `days_booked_in_advance` integer
    - `entitled` integer
    - `created_at` string
    - `created_by` integer
    - `updated_at` unknown
    - `updated_by` unknown
    - `deleted_at` unknown
    - `deleted_by` unknown
  - `token` string
  - `error` unknown

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `ffb87b44c733`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/humanity-com/apis/humanity/changes/leave-types%3Faccess_token=:{token}/post.md)

---

[API](https://skmtc.dev/humanity-com/apis/humanity.md) - [All operations](https://skmtc.dev/humanity-com/apis/humanity/llms.txt) - [OpenAPI document](https://skmtc.dev/humanity-com/apis/humanity/revisions/ffb87b44c733?raw)
