Skip to main content
POST

Authorizations

Authorization
string
header
required

Body

application/json
type
enum<string>
required
Available options:
vacation,
out_of_office
title
string
required
Maximum string length: 255
startDate
string<date>
required
endDate
string<date>
required
users
object

User-based target. Mutually exclusive with team. Provide exactly one of emails, slugs or uuids.

team
object

Team-based target. Mutually exclusive with users. Provide exactly one of uuid or slug.

startHalfDay
boolean
endHalfDay
boolean
startHalfDayCutoff
string | null

Half-day cutoff (HH:MM). Required when startHalfDay is true.

endHalfDayCutoff
string | null

Half-day cutoff (HH:MM). Required when endHalfDay is true.

note
string | null
Maximum string length: 1000

Response

At least one period was created or replaced.

users
object[]
required
Last modified on April 29, 2026