CalDAV icon

CalDAV

Interact with CalDAV servers to manage calendars, events, todos, and free/busy information

Actions15

Overview

This node is designed to interact with calendar events via the CalDAV protocol. Specifically, the "Get" operation under the "Event" resource allows users to retrieve detailed information about a single calendar event by specifying its unique identifier and the calendar URL it belongs to.

Common scenarios for this node include:

  • Fetching details of a specific event from a user's calendar for display or processing.
  • Integrating calendar event data into workflows such as reminders, notifications, or syncing with other systems.
  • Automating retrieval of event metadata for reporting or auditing purposes.

For example, a user might provide the URL path to their personal calendar collection and the unique event ID to fetch all details about that event, including start time, end time, description, attendees, etc.

Properties

Name Meaning
Calendar URL The URL path of the calendar collection where the event resides (e.g., /calendars/user@example.com/personal/). This identifies which calendar to query.
Event UID The unique identifier of the event to retrieve (e.g., event-12345@example.com). This specifies exactly which event's details to fetch.

Output

The node outputs JSON data representing the full details of the requested calendar event. This typically includes fields such as event summary, start and end times, location, description, attendees, recurrence rules, and any other metadata associated with the event in the CalDAV server.

If the event contains any binary attachments or related files, those would be represented in the binary output section, but based on the provided code and properties, the primary output is structured JSON event data.

Dependencies

  • Requires access to a CalDAV-compatible calendar server.
  • Needs the calendar URL and event UID to identify and fetch the event.
  • Requires appropriate authentication credentials configured in n8n to access the CalDAV server (e.g., username/password or API token), though these are not explicitly shown in the source code snippet.

Troubleshooting

  • Invalid Calendar URL: If the calendar URL is incorrect or inaccessible, the node will fail to retrieve the event. Verify the URL path matches the calendar collection on the server.
  • Event Not Found: Providing an incorrect or non-existent event UID will result in no data returned or an error indicating the event could not be found.
  • Authentication Errors: Missing or invalid credentials for the CalDAV server will cause authorization failures. Ensure proper credentials are set up in n8n.
  • Network Issues: Connectivity problems to the CalDAV server can cause timeouts or errors. Check network access and server availability.

Links and References

Discussion