Create Booking
Creates a booking 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
| Property | Field | Description |
|---|---|---|
| Attendee Email | inAttendeeEmail | Email address of the attendee |
| Attendee Name | inAttendeeName | Full name of the attendee |
| Attendee Time Zone | inAttendeeTimeZone | Time zone of the attendee (e.g. America/New_York) |
| Client ID | inClientID | Client ID from Connect node |
| Event Type ID | inEventTypeID | The ID of the event type to book |
| Guests | inGuests | Array of guest email addresses (optional) |
| Metadata | inMetadata | Custom metadata key-value pairs (optional，max 50 keys) |
| Start Time | inStartTime | Booking start time in ISO 8601 UTC format (e.g. 2024-08-13T09:00:00Z) |
Outputs
| Property | Field | Description |
|---|---|---|
| Booking UID | outBookingUID | Unique identifier of the created booking |
| Result | outResult | Full booking response |
| Status | outStatus | Booking status (e.g. ACCEPTED) |
Options
| Property | Field | Description |
|---|---|---|
| Attendee Language | optLanguage | Language code for attendee notifications (e.g. en，fr，de) |
| Credentials | optCredentials | Cal.com API key (optional if using Connect node) |
| Duration (minutes) | optDuration | Custom duration in minutes (optional，overrides event type default) |
| Timeout (seconds) | optTimeout | Maximum time in seconds to wait |
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 > Securitybase_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.
Related nodes
Get Booking · List Bookings · 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
- Cal.com — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries