---
title: "Create Time-Off Event"
method: POST
path: "/employer/time-off-events"
tags: ["Time Off (Beta)"]
---

# Create Time-Off Event

`POST /employer/time-off-events`

**Beta:** This endpoint is in beta and may change.
Create a new time-off request or event

## Headers

- `Finch-API-Version` string, date, required

## Request body

- CreateTimeOffEventRequest — Request body for creating a new time-off event.
  - `individual_id` string, uuid, required — A stable Finch `id` (UUID v4) for an individual in the company.
  - `reviewer_id` string, uuid, nullable — The ID of the employee who reviewed/approved this request.
  - `status` 'requested' | 'approved' | 'declined' | 'cancelled' | 'deleted', required — The status of the time-off request.
  - `policy_type` 'pto' | 'sick' | 'parental' | 'unpaid' | 'other' | 'null', nullable — The type of time-off policy.
  - `event_type` 'vacation' | 'sick' | 'personal' | 'jury_duty' | 'volunteer' | 'bereavement' | 'other', required — The specific type of time-off event.
  - `start_date` string, date-time, nullable, required — ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.
  - `end_date` string, date-time, nullable, required — ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

## Response `201`

Time-off event creation initiated

- CreateTimeOffEventResponse
  - `time_off_event_id` string, uuid, required — The id of the time-off event.
  - `job_id` string, uuid, required

## Other responses

- `400` — Bad request - invalid parameters
- `422` — Request provided with unsupported parameters

## Changes

- **2025-07-25** `73c284d36c1e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/finch-api/apis/api-reference/changes/employer/time-off-events/post.md)

---

[API](https://skmtc.dev/finch-api/apis/api-reference.md) · [All operations](https://skmtc.dev/finch-api/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/finch-api/api-reference/revisions/e8b684dbd61d/schema)