Skip to main content

List Bookings

Lists bookings in Cal.com.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties​

Every node shares these.

  • Name — the node's display name on the canvas.
  • Color — the node's colour on the canvas.
  • Delay Before (sec) — wait this long before the node runs.
  • Delay After (sec) — wait this long after the node runs.
  • Continue On Error — carry on instead of failing the flow. Defaults to false.
info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Inputs​

PropertyFieldDescription
Client IDinClientIDClient ID from Connect node

Outputs​

PropertyFieldDescription
BookingsoutBookingsArray of booking objects
CountoutCountNumber of bookings returned
ResultoutResultFull API response with bookings array

Options​

PropertyFieldDescription
CredentialsoptCredentialsCal.com API key (optional if using Connect node)
LimitoptTakeMaximum number of bookings to return
SkipoptSkipNumber of bookings to skip (for pagination)
Status FilteroptStatusFilter bookings by status One of: ALL, upcoming, recurring, past, cancelled, unconfirmed.

Requirements​

  • A Client ID from this package's Connect node, unless you set credentials directly on this node.
  • Cal.com API Key — API key for Cal.com authentication
    • value — API Key (password, required). Your Cal.com API key from Settings > Security
    • base_url — Base URL (text, optional). API base URL (leave empty for cal.com cloud, set for self-hosted)

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.

Create Booking · Get Booking · Cancel Booking · Reschedule Booking

Elsewhere in the package: Connect · Disconnect · List Event Types · Create Event Type · Update Event Type · Get Available Slots · List Schedules · Create Schedule · Toolkit

See also​