List Events
Lists upcoming events from a Google Calendar.
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 ID - Email address or calendar ID to list events from.
Options
- Credentials - Google Calendar credentials used to authenticate with the service.
- Max Results - Maximum number of events to return. Default is 25.
Output
- result - An array of upcoming event objects.
How It Works
The List Events node integrates with Google Calendar to list upcoming events. When executed, the node:
- Authenticates with Google Calendar using the provided credentials
- Lists upcoming events from the specified calendar
- Returns an array of event objects as the result
Requirements
- A valid Google Calendar account
- Valid Google Calendar credentials
- Valid Calendar ID (email address or calendar ID)
Error Handling
The node will return specific errors in the following cases:
- Invalid value for Max Results (must be greater than 0)
- Empty or invalid Google Calendar credentials
- Google Calendar service errors
Usage Notes
- The Calendar ID can be an email address or calendar ID. If not provided, the primary calendar is used.
- By default, the node lists events starting from the current time
- Deleted events are not included in the results
- Recurring events are expanded into individual events
- Events are ordered by start time
- The result contains an array of event objects with fields like id, summary, description, start, end, attendees, etc.
- The default maximum number of results is 25, but this can be adjusted using the Max Results option