Overview
This node interacts with CalDav/CardDav servers to manage calendar events. Specifically, the "Event - Get Many" operation retrieves multiple calendar events within a specified time range from a given calendar URL. This is useful for synchronizing events, displaying upcoming appointments, or aggregating calendar data from CalDav-compatible services like Baikal or SabreDAV.
Practical examples:
- Fetch all events scheduled between two dates to display in a custom dashboard.
- Synchronize events from an external CalDav calendar into another system.
- Generate reports based on events occurring within a specific timeframe.
Properties
| Name | Meaning |
|---|---|
| Calendar URL | URL of the calendar (DAV collection) from which to fetch events. |
| Start Time | The start datetime boundary to filter events (inclusive). |
| End Time | The end datetime boundary to filter events (inclusive). |
Output
The output is an array of JSON objects representing the events retrieved from the specified calendar URL within the given time range. Each item in the output contains a json property holding the event data as returned by the CalDav server.
The exact structure of each event depends on the CalDav server's response but typically includes details such as event UID, start and end times, summary, description, location, and other standard iCalendar properties.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a CalDav/CardDav server supporting calendar collections.
- Needs an API key credential configured in n8n for authenticating with the CalDav server.
- Uses internal helper functions (
getEvents) to interact with the CalDav server API.
Troubleshooting
Common issues:
- Invalid or unreachable Calendar URL: Ensure the URL points to a valid CalDav calendar collection.
- Authentication failures: Verify that the API key credential is correctly set up and has access rights.
- No events returned: Confirm that events exist in the specified time range and calendar.
Error messages:
"No credentials found": Indicates missing or misconfigured authentication credentials; check the node’s credential settings.- Network or timeout errors: Check network connectivity and CalDav server availability.
- Parsing errors: May occur if the CalDav server returns unexpected data; verify server compatibility.