POST
/
employer
/
time-off-events
Create Time-Off Event
curl --request POST \
  --url https://api.tryfinch.com/employer/time-off-events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Finch-API-Version: <finch-api-version>' \
  --data '{
  "individual_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "reviewer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "status": "requested",
  "policy_type": "pto",
  "event_type": "vacation",
  "start_date": "2023-11-07T05:31:56Z",
  "end_date": "2023-11-07T05:31:56Z"
}'
{
  "time_off_event_id": "e1f2a3b4-c5d6-7e8f-9a0b-1c2d3e4f5a6b",
  "job_id": "f2a3b4c5-d6e7-8f9a-0b1c-2d3e4f5a6b7c"
}

Authorizations

​
Authorization
string
header
required

Please use your Access Token

Headers

​
Finch-API-Version
string<date>
default:2020-09-17
required

Header used to specify the version for a given API request. Current version is 2020-09-17.

Body

application/json

Request body for creating a new time-off event.

​
individual_id
string<uuid>
required

A stable Finch id (UUID v4) for an individual in the company.

​
status
enum<string>
required

The status of the time-off request.

Available options:
requested,
approved,
declined,
cancelled,
deleted
​
event_type
enum<string>
required

The specific type of time-off event.

Available options:
vacation,
sick,
personal,
jury_duty,
volunteer,
bereavement,
other
​
start_date
string<date-time> | null
required

ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

​
end_date
string<date-time> | null
required

ISO 8601 datetime format (YYYY-MM-DDTHH:MM:SS). Default timestamps for start_date and end_date are 00:00:00 (beginning of day) and 23:59:59 (end of day), respectively. Note: Datetime values are represented in the timezone they are reflected in the provider.

​
reviewer_id
string<uuid> | null

The ID of the employee who reviewed/approved this request.

​
policy_type
enum<string> | null

The type of time-off policy.

Available options:
pto,
sick,
parental,
unpaid,
other

Response

Time-off event creation initiated

​
time_off_event_id
string<uuid>
required

The id of the time-off event.

​
job_id
string<uuid>
required