Skip to main content

Get Availability

Checks the availability of multiple Google Calendars within a specified time range.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Calendar IDs - List of calendar IDs to check availability for.
  • Time Min - Start time for availability check (RFC3339 format).
  • Time Max - End time for availability check (RFC3339 format).

Options​

  • Credentials - Google Calendar credentials used to authenticate with the service.

Output​

  • result - Availability information for the specified calendars, including busy times and errors.

How It Works​

The Get Availability node integrates with Google Calendar to check the availability of multiple calendars within a specified time range. When executed, the node:

  1. Validates the provided inputs (Calendar IDs, Time Min, Time Max)
  2. Authenticates with Google Calendar using the provided credentials
  3. Creates a freebusy query request for all specified calendars
  4. Executes the freebusy query to check calendar availability
  5. Processes and formats the response for better usability
  6. Returns detailed availability information as the result

Requirements​

  • A valid Google Calendar account
  • Valid Google Calendar credentials
  • At least one valid Calendar ID
  • Properly formatted RFC3339 timestamps for Time Min and Time Max
  • Time Max must be after Time Min

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Calendar IDs list
  • Invalid time format for Time Min or Time Max (must be RFC3339)
  • Time Max is before Time Min
  • Empty or invalid Google Calendar credentials
  • Google Calendar service errors

Usage Notes​

  • Calendar IDs should be provided as an array of strings
  • Time Min and Time Max must be in RFC3339 format (e.g. 2024-03-20T15:30:00Z)
  • The result includes detailed availability information for each calendar:
    • Busy times (start and end timestamps)
    • Any errors encountered for each calendar
  • The result also includes the raw Google Calendar API response with timeMin, timeMax, calendars, groups, and kind fields
  • This node is particularly useful for scheduling applications to find available time slots across multiple calendars