---
title: "Create a new Time Off"
method: POST
path: "/v2/timeoff"
tags: ["TimeOffs"]
---

# Create a new Time Off

`POST /v2/timeoff`

Creates a new Time Off and returns the created Time Off object.

## Headers

- `Authorization` string, required

## Request body

- CreateTimeOffV2Dto
  - `techId` string, required — The tech ID to assign the time off to (prefix `USR-`). Use `-1` to assign to all company techs.
  - `startDate` string, date-time, required — The time & date when the time off starts.
  - `endDate` string, date-time, required — The time & date when the time off ends.
  - `status` 'approved' | 'pending' | 'declined' — The status of the time off request.
  - `reason` 'Vacation' | 'Sick day' | 'Personal' | 'Company Added' | 'Other' — Reason for the time off.
  - `details` string — Details about the time off.
  - `isAllDay` boolean — Whether the time off is for the entire day.

## Response `201`

The created Time Off.

- ResponseTimeOffV2Dto
  - `id` string — The ID of the time off.
  - `techId` string — The assigned tech ID (prefix `USR-`). Use `-1` to assign to all company techs.
  - `startDate` string, date-time — The time & date when the time off starts.
  - `endDate` string, date-time — The time & date when the time off ends.
  - `status` 'approved' | 'pending' | 'declined' — The status of the time off.
  - `reason` 'Vacation' | 'Sick day' | 'Personal' | 'Company Added' | 'Other' — The reason for the time off.
  - `details` string — Details about the time off.
  - `isAllDay` boolean — Whether the time off is for the entire day.
  - `updatedAt` string, date-time — The date and time the time off was updated.
  - `createdAt` string, date-time — The date and time the time off was created.

## Other responses

- `400` — Invalid input.
- `401` — Missing or invalid authentication token.

---

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