CALENDAR_GET_FREEBUSY

What it does

Get busy blocks for a calendar in a window.

Inputs & outputs

Configuration

Name	Type	Required
calendarGrantId	string	Yes
calendarId	string	No

Example

Example

Before creating a meeting slot, check whether the host's calendar is already occupied. Wire timeMin and timeMax to the proposed slot's ISO 8601 start and end times. The node returns busy — an array of overlapping time blocks on the configured calendar. Route through a CONDITIONAL: if busy is empty the slot is free and you can proceed to CALENDAR_CREATE_EVENT; otherwise branch to notify the requester that the time is unavailable. For multi-attendee scenarios, use CALENDAR_FIND_AVAILABILITY instead, which queries multiple grants at once and computes mutual free slots.