Actions4
Overview
This node interacts with CalDAV servers to manage calendar events. Specifically, the "Get Events in Range" operation retrieves all calendar events within a specified date range from a selected calendar. This is useful for scenarios such as syncing events from an external calendar into n8n workflows, generating reports of upcoming events, or triggering actions based on scheduled events within a timeframe.
For example, you could use this node to fetch all meetings scheduled in your work calendar for the next week and then send reminders or create tasks based on those events.
Properties
| Name | Meaning |
|---|---|
| Calendar Name or ID | Select the calendar to query events from. You can choose from a list of available calendars or specify a calendar ID using an expression. |
| Selected Calendar Path Preview | Displays the currently selected calendar path for confirmation (read-only notice). |
| Start Date | The start date/time for the range query. Only events occurring on or after this date will be returned. |
| End Date | The end date/time for the range query. Only events occurring on or before this date will be returned. |
| Options | Additional options for the query: |
| - Include All-Day Events | Boolean flag indicating whether to include all-day events in the results (default: true). |
| - Max Results | Maximum number of events to return (default: 100). |
Output
The output is a JSON array where each item represents a calendar event retrieved within the specified date range. Each event object contains details such as title, start and end times, and other event metadata as provided by the CalDAV server.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a CalDAV server.
- Requires an API key credential configured in n8n for authenticating with the CalDAV service.
- Uses internal helper functions to load available calendars and fetch events from the CalDAV server.
Troubleshooting
- Empty results: Ensure the calendar path is correct and that there are events within the specified date range.
- Authentication errors: Verify that the API key credential is correctly set up and has sufficient permissions.
- Error message "Event with UID '...' not found": This applies to other operations but indicates that the specified event does not exist in the selected calendar.
- Max Results too low: If you expect more events, increase the "Max Results" option to avoid truncation.