Skip to main content
POST
Reserve a slot

Authorizations

Authorization
string
header
required

Use the Authorization header with Bearer scheme.

Examples:

  • API Key: Authorization: Bearer calid_xxxxx

Body

application/json
eventTypeId
integer
required

Event type identifier for the slot reservation.

Required range: x > 1
Example:

123

slotStart
string<date-time>
required

Slot start time in ISO-8601 format with timezone offset.

Example:

"2026-05-02T10:00:00.000Z"

slotDuration

Optional duration in minutes. Can be sent as a number or numeric string and must match event type allowed durations when configured.

Pattern: ^[1-9]\d*$
Example:

"30"

reservationDuration
integer

Optional reservation hold duration in minutes. Defaults to 5 when omitted and requires authenticated requests.

Required range: x > 1
Example:

10

Response

Reservation response

Reservation response

success
enum<boolean>
required
Available options:
true
data
object
message
string
meta
object