List private links - Automate.ax

calcom.listPrivateLinks lists private scheduling links for an event type.

automations/list-private-links.automation.ts

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

export default automation("List private links", () => {
  markSignificant(calcom.listPrivateLinks({ eventTypeId: 23 }))
})

Input

Pass these fields:

Field	Type	Required	Description
`eventTypeId`	`integer`	Yes	Must be greater than 0.

Output

Returns an array containing time-based and usage-based links. Both variants include:

Field	Type	Required	Description
`linkId`	`string`	Yes	Private link identifier.
`eventTypeId`	`number`	Yes	Event type that owns the link.
`isExpired`	`boolean`	Yes	Whether the link has expired.
`bookingUrl`	`string (uri)`	Yes	Full private booking URL.

A time-based link also has required expiresAt: string. A usage-based link instead has required maxUsageCount: number and usageCount: number. 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.