List out of office entries - Automate.ax

calcom.listOutOfOfficeEntries lists the connected user’s out-of-office entries.

automations/list-out-of-office-entries.automation.ts

import { automation, markSignificant } from "automate.ax"
import { calcom } from "automate.ax/calcom"

export default automation("List out of office entries", () => {
  markSignificant(
    calcom.listOutOfOfficeEntries({ skip: 0, take: 250, sortStart: "asc" }),
  )
})

Input

Pass these fields:

Field	Type	Required	Description
`skip`	`integer`	No	Default: `0`. Minimum: 0.
`sortEnd`	`"asc" \| "desc"`	No	—
`sortStart`	`"asc" \| "desc"`	No	—
`take`	`integer`	No	Default: `250`. Must be greater than 0. Maximum: 250.

Output

Returns an array. Each item has these fields:

Field	Type	Required	Description
`userId`	`number`	Yes	The ID of the user.
`toUserId`	`number`	No	The ID of the user covering for the out of office period, if applicable.
`id`	`number`	Yes	The ID of the ooo entry.
`uuid`	`string`	Yes	The UUID of the ooo entry.
`start`	`string (date-time)`	Yes	The start date and time of the out of office period in ISO 8601 format in UTC timezone.
`end`	`string (date-time)`	Yes	The end date and time of the out of office period in ISO 8601 format in UTC timezone.
`notes`	`string`	No	Optional notes for the out of office entry.
`reason`	`"unspecified" \| "vacation" \| "travel" \| "sick" \| "public_holiday"`	No	the reason for the out of office entry, if applicable

Cal.com enforces account role, plan, and availability requirements. Provider rejections surface as structured action failures with the HTTP status and any Retry-After delay.