---
title: "Create a leave type"
method: POST
path: "/leave_types"
tags: ["Leave types"]
---

# Create a leave type

`POST /leave_types`

Create a leave type

## Request body

- object
  - `name` string, required
  - `color` string, required
  - `needs_approval` boolean, required
  - `maximum_absent` boolean, required
  - `leave_unit` 'days' | 'half_days' | 'hours' | 'minutes_30' | 'minutes_15' | 'minutes_10' | 'minutes_5' | 'minutes_1', required
  - `position` number, required
  - `take_from_allowance` boolean, required
  - `privacy_hide_leavetype` boolean, required
  - `outlook_synchronization_show_as` 'free' | 'tentative' | 'busy' | 'oof' | 'workingElsewhere' | 'unknown', required
  - `outlook_synchronization_subject` string, nullable, required
  - `icon` 'NoIcon' | 'Umbrella' | 'Anchor' | 'Archive' | 'Award' | 'Briefcase' | 'Calendar' | 'Cast' | 'Clock' | 'Coffee' | 'Compass' | 'Battery' | 'Emoji' | 'Gift' | 'Frown' | 'Image' | 'Sun' | 'Zap' | 'Home' | 'Users', required
  - `reason_mandatory` boolean, required
  - `reason_hint_text` string, nullable, required
  - `allowance_type_id` string, nullable, required
  - `ignore_schedule` boolean, required
  - `sync_option` 'Disabled' | 'All' | 'OnlyApproved', required
  - `ignore_public_holidays` boolean, required
  - `reason_visibility_public` boolean, required
  - `counts_as_leave` boolean
  - `allow_representative_overlap` boolean
  - `translations` object[] — Optional per-language names, shown to members using that language.
    - `language` 'en' | 'de' | 'fr' | 'hu' | 'it' | 'pl' | 'pt' | 'ru' | 'es' | 'tr' | 'uk', required — Language code the name below is written in, e.g. `de`.
    - `name` string, required

## Response `200`

Successful response

- string, uuid

## Other responses

- `400` — Invalid input data
- `401` — Authorization not provided
- `403` — Insufficient access
- `500` — Internal server error

---

[API](https://skmtc.net/absentify/apis/absentify-crud-api.md) · [All operations](https://skmtc.net/absentify/apis/absentify-crud-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/absentify/absentify-crud-api/revisions/ef777d51e6f2/schema)