Create out of office entry - Automate.ax

calcom.createOutOfOfficeEntry creates an out-of-office entry for the connected user.

automations/create-out-of-office-entry.automation.ts

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

export default automation("Create out of office entry", () => {
  markSignificant(
    calcom.createOutOfOfficeEntry({
      start: "2026-09-10T00:00:00.000Z",
      end: "2026-09-12T00:00:00.000Z",
      reason: "travel",
      notes: "Conference",
    }),
  )
})

Input

Pass these fields:

Field	Type	Required	Description
`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.
`toUserId`	`number`	No	The ID of the user covering for the out of office period, if applicable.
`reason`	`"unspecified" \| "vacation" \| "travel" \| "sick" \| "public_holiday"`	No	the reason for the out of office entry, if applicable

Output

Returns an object with 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.