CalDAV Node icon

CalDAV Node

Use a CalDAV Server

Actions4

Overview

This node integrates with a CalDAV server to fetch calendar events by their unique URL or ID. It is useful when you want to retrieve detailed information about a specific event from a calendar, especially when you have the event's direct link or identifier rather than searching by date or other criteria.

Common scenarios include:

  • Synchronizing a particular event's details into another system.
  • Fetching event data for display or processing based on a known event URL.
  • Debugging or auditing event information by retrieving raw calendar data.

For example, if you have an event URL from your calendar application, you can use this node to pull all its details, including optional raw iCalendar data, which can be used for advanced processing or troubleshooting.

Properties

Name Meaning
Calendar Name or ID Selects the calendar containing the event. You can choose from a list of calendars connected to your account or specify a calendar URL/ID directly using expressions.
Event URL or ID The unique identifier or URL of the event you want to fetch. This is typically provided by the calendar system and uniquely identifies the event within the selected calendar.
Include Raw Calendar Data (Optional) When enabled, includes the raw iCalendar (ICS) data of the event in the output. This contains all technical details of the event in standard calendar format, useful for debugging or accessing advanced properties.

Output

The node outputs JSON data representing the fetched event's details. The structure typically includes standard event fields such as title, start and end times, description, location, attendees, and other metadata depending on the calendar system.

If the "Include Raw Calendar Data" option is enabled, the output will also contain the full raw iCalendar (ICS) content of the event, providing access to all underlying event properties in the standard calendar format.

No binary data output is produced by this node.

Dependencies

  • Requires connection to a CalDAV-compatible calendar server.
  • Needs appropriate API credentials or authentication tokens configured in n8n to access the calendar data.
  • The node depends on internal methods and actions defined in the bundled source code to interact with the CalDAV server.

Troubleshooting

  • Common Issues:

    • Incorrect calendar ID or URL may result in failure to find the event.
    • Invalid or expired authentication credentials can cause authorization errors.
    • Providing an invalid or malformed event URL/ID will prevent successful retrieval.

  • Error Messages:

    • Errors indicating "unknown resource" suggest misconfiguration of the resource parameter.
    • Authorization errors usually mean the API key or token is missing or invalid; reconfigure credentials.
    • If the event is not found, verify that the calendar and event identifiers are correct and accessible.

  • Resolutions:

    • Double-check calendar and event identifiers.
    • Ensure valid and active credentials are set up in n8n.
    • Use the raw ICS data output to debug event details if needed.

Links and References

Discussion