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