---
title: "Create a new time-off request already approved."
method: POST
path: "/time-off/requests/processed"
tags: ["Time off"]
---

# Create a new time-off request already approved.

`POST /time-off/requests/processed`

This endpoint creates a new time-off request for a specified *_userId* and existing *_timeOffTypeId* within a defined date range specified by the *from* (start) and *to* (end) fields. The request will be listed in the app in the **Time-off history** as 'submitted time off on behalf of' the person assigned to the request.

Additionally, it is possible to indicate whether the 'from' and 'to' dates are taken as full days using the optional fields *partOfDayFrom* and *partOfDayTo*, respectively. If these optional parameters are not provided, the time-off request creation defaults to full days for both the *from* and *to* dates.
All requests will be made on behalf of the *_userId*, and the status of the request will be 'Processed' if the dates (from and to) are in the past, while if the dates are in the future, the status will be 'Submitted'.

This endpoint does not allow creating time-off requests of hourly type.

For the optimal performance of this endpoint, it supports up to 200 requests per minute. Please note, rapidly consecutive requests to this endpoint may not be processed in the submitted order. We recommend spacing out your requests for consistent processing results.

## Headers

- `Authorization` string, required

## Request body

- object
  - `_userId` string, required — The Kenjo employee *_id*.
  - `_timeOffTypeId` string, required — The Kenjo *time-off type Id* of one existing time-off type.
  - `from` string, required — The starting date of the time-off request in format YYYY-MM-DD.
  - `to` string, required — The ending date of the time-off request in format YYYY-MM-DD.
  - `partOfDayFrom` 'StartOfDay' | 'HalfOfDay' — The duration of the *from* date. 'StartOfDay' means that the *from* date is the entire day. 'HalfOfDay' means that the request starts to apply in the middle of the *from* day. If not specified, the default value will be 'StartOfDay'.
  - `partOfDayTo` 'HalfOfDay' | 'EndOfDay' — The duration of the *to* date. 'EndOfDay' means that the *to* date is the entire day. 'HalfOfDay' means the request starts to apply in the middle of the *to* day. If not specified, the default value will be 'EndOfDay'.
  - `description` string — The description of the time-off request. Maximun length 1000 characters.

## Response `201`

CREATED

- object
  - `_id` string — The time off request identifier.
  - `_userId` string — The Kenjo employee *_id*.
  - `_timeOffTypeId` string — The Kenjo *time-off type Id* for an existing time-off type.
  - `from` string — The starting date of the time-off request in format YYYY-MM-DD.
  - `to` string — The ending date of the time-off request in format YYYY-MM-DD.
  - `partOfDayFrom` 'StartOfDay' | 'HalfOfDay' — Indicates when starts to apply the *from* date.
  - `partOfDayTo` 'HalfOfDay' | 'EndOfDay' — Indicates when starts to apply the *to* date.
  - `description` string — The description of the time-off request. Maximun length 1000 characters.

## Other responses

- `400` — BAD REQUEST. This is a wrong request in the client side due to invalid body or params.
- `401` — UNAUTHORIZED. The Authorization header is incorrect, not provided or the token expired.

---

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