---
title: "Create an Leave Request"
method: POST
path: "/time/leaverequests"
tags: ["LeaveRequests"]
---

# Create an Leave Request

`POST /time/leaverequests`

## Request

- Base URL: `https://{company}.keka.com/api/v1`
- URL: `https://{company}.keka.com/api/v1/time/leaverequests`
- Auth: OAuth 2
  - Implicit: `https://login.kekad.com/connect/authorize`

Create an leave request and returns leave request identifier.

## Request body

- PostLeaveRequest
  - `employeeId` string, required
  - `requestedBy` string, required
  - `fromDate` string, date-time, required
  - `toDate` string, date-time, required
  - `fromSession` 0 | 1
  - `toSession` 0 | 1
  - `leaveTypeId` string, required
  - `reason` string, required
  - `note` string, nullable

## Response `200`

Success

- StringResponse: class represents response.
  - `succeeded` boolean: Gets or sets a value indicating whether this Keka.API.Web.Core.Response`1 is succeeded.
  - `message` string, nullable: Gets or sets the message.
  - `errors` string[], nullable: Gets or sets the errors.
  - `data` string, nullable: Gets or sets the data.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/keka/apis/leave.md) - [All operations](https://skmtc.dev/keka/apis/leave/llms.txt) - [OpenAPI document](https://skmtc.dev/keka/apis/leave/revisions/8ba3582d4f47?raw)