---
title: "Add Out of Office"
method: POST
path: "/business/v2/employees/out-of-office"
tags: ["Out of Office"]
---

# Add Out of Office

`POST /business/v2/employees/out-of-office`

## Request

- Base URL: `https://api.soldo.com`
- URL: `https://api.soldo.com/business/v2/employees/out-of-office`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://api.soldo.com/oauth/authorize` scopes: `out_of_office_delegation_write`

Endpoint to add an `out_of_office`.

## Headers

- `X-Soldo-Fingerprint` string, required: [Advanced authentication](ref:advanced-authentication): `SHA512SUM` of the fingerprint values listed in the fingerprint order for this endpoint.
- `X-Soldo-Fingerprint-Signature` string, required: [Advanced authentication](ref:advanced-authentication): Signature of the `X-Soldo-Fingerprint`.

## Request body

- CreateOutOfOfficeDelegation: Create `out_of_office` JSON parameters.
  - `request_timestamp` integer, required: The epoch timestamp in millis. This is checked in Soldo. Requests with timestamp older than 5 seconds will be rejected.
  - `delegator_id` string, required: The ID of the person assigning the `out_of_office`.
  - `delegate_id` string, required: The ID of the person covering for the delegator.
  - `from_date` string: Defines when the out_of_office entry starts. fromDate included.(i.e. greater than or equal to) (Format: `yyyy-MM-dd`).
  - `to_date` string: Defines when the out_of_office entry ends. toDate included.(i.e. less than) (Format: `yyyy-MM-dd`).
  - `features` DelegationFeature[], required: The features of `out_of_office`.

## Response `200`

The result is a single `out_of_office`.

- OutOfOfficeDelegation
  - `id` string: A unique identifier for this `out_of_office` entry.
  - `delegator_id` string: The ID of the person assigning the `out_of_office`.
  - `delegate_id` string: The ID of the person covering for the delegator.
  - `from_date` string, date: Defines when the out_of_office entry starts. fromDate included. (i.e. greater than or equal to) (Format:`yyyy-MM-dd`).
  - `to_date` string, date: Defines when the out_of_office entry ends. toDate included. (i.e. less than) (Format:`yyyy-MM-dd`).
  - `features` DelegationFeature[]: The features of `out_of_office`.
  - `status` 'ACTIVE' | 'EXPIRED' | 'SCHEDULED' | 'DELETED'

## Other responses

- `400`: Your request has missing arguments or is malformed.
- `404`: One or more resource requested does not exist.

---

[API](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0.md) - [All operations](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/soldo/apis/soldo-business-api-v2-0/revisions/23fc5d07b367?raw)