---
title: "Create a time off request"
method: POST
path: "/v1/companies/{company_uuid}/time_off/requests"
tags: ["Time Off Requests"]
---

# Create a time off request

`POST /v1/companies/{company_uuid}/time_off/requests`

## Request

- Base URL: `https://api.gusto-demo.com`
- URL: `https://api.gusto-demo.com/v1/companies/{company_uuid}/time_off/requests`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/gusto/apis/gusto-api/docs/v1/companies/:company_uuid/time_off/requests/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a time off request for an employee

scope: `time_off_requests:write`

## Path parameters

- `company_uuid` string, required

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Request body

- object
  - `employee_uuid` string, required: The UUID of the employee
  - `policy_uuid` string, required: The UUID of the time off policy
  - `employee_note` string: A note from the employee about the request
  - `start_date` string, required: The start date of the time off request (YYYY-MM-DD)
  - `end_date` string, required: The end date of the time off request (YYYY-MM-DD)
  - `days` object, required: An object where keys are dates in YYYY-MM-DD format and values are hours as string decimals (e.g. {"2025-01-20": "8.000"})

## Response `201`

created

- EmbeddedTimeOffRequest: The representation of a time off request.
  - `uuid` string, required: The UUID of the time off request.
  - `status` 'pending' | 'approved' | 'declined' | 'consumed', required: The status of the time off request.
  - `employee_note` string, nullable, required: A note about the time off request, from the employee to the employer.
  - `employer_note` string, nullable, required: A note about the time off request, from the employer to the employee.
  - `policy_type` string, nullable, required: The type of the time off policy (e.g. vacation, sick).
  - `policy_uuid` string, nullable, required: The UUID of the time off policy associated with this request.
  - `days` object, required: An object where keys are dates in YYYY-MM-DD format and values are hours as string decimals (e.g. {"2025-01-20": "8.000"}).
  - `employee` object, required
    - `uuid` string: The UUID of the employee the time off request is for.
    - `full_name` string: The full name of the employee the time off request is for.
  - `initiator` object, nullable, required
    - `uuid` string: The UUID of the employee who initiated the time off request.
    - `full_name` string: The full name of the employee who initiated the time off request.
  - `approver` object, nullable, required: This value will be null if the request has not been approved.
    - `uuid` string: The UUID of the employee who approved the time off request.
    - `full_name` string: The full name of the employee who approved the time off request.

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/gusto/apis/gusto-api.md) - [All operations](https://skmtc.dev/gusto/apis/gusto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gusto/apis/gusto-api/revisions/f98575fa2a5e?raw)