Request vacation

Creates a new vacation request for the current employee.

How vacation requests work:

Employee submits a vacation request with start and end dates
Request status is set to “Pending”
Manager reviews and approves or rejects the request
System automatically checks for scheduling conflicts

Validation rules:

Start date cannot be more than one month in the past
End date must be after start date
System checks for overlapping events (other vacations, sick days, etc.)

Note: This endpoint is only available for employee accounts. Only pending vacations can be modified or canceled.

POST/account/employee/vacations/request

Authorization

AuthorizationOAuth2 access token · headerrequired

Scopes:api:write

AuthorizationBearer token (JWT) · headerrequired

Request body

requiredapplication/json

dateFromstring<date-time>required

Start date of vacation

dateTostring<date-time>required

End date of vacation

Responses

200

successbooleanrequired

Operation success flag

400

Validation errors

errorsobject

Show properties

dateFromstring[]

dateTostring[]

globalErrorsstring[]

messagestring

statusCodenumber

401

Unauthorized - Invalid or missing authentication token

403

Forbidden - Insufficient API scopes or permissions

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

OAuth2 access tokenRemember on this deviceInclude my values in samples

Bodyapplication/json

dateFromstring*Start date of vacationdateTostring*End date of vacation

Request

curl -X POST "https://leadtime.app/api/public/account/employee/vacations/request" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dateFrom": "2024-06-01T00:00:00.000Z",
  "dateTo": "2024-06-05T00:00:00.000Z"
}'

const response = await fetch("https://leadtime.app/api/public/account/employee/vacations/request", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"dateFrom\": \"2024-06-01T00:00:00.000Z\",\n  \"dateTo\": \"2024-06-05T00:00:00.000Z\"\n}"
});

import requests

response = requests.post(
    "https://leadtime.app/api/public/account/employee/vacations/request",
    headers={
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"dateFrom\": \"2024-06-01T00:00:00.000Z\",\n  \"dateTo\": \"2024-06-05T00:00:00.000Z\"\n}",
)

Response

{
  "success": true
}

{
  "errors": {
    "dateFrom": [
      "Vacation start date cannot be more than one month in the past."
    ],
    "dateTo": [
      "Vacation end date must be after start date."
    ],
    "globalErrors": [
      "There are already other events for this period. Please select another one."
    ]
  },
  "message": "Bad Request",
  "statusCode": 400
}