CalDAV icon

CalDAV

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

Actions15

Overview

This node interacts with calendar events via the CalDAV protocol. Specifically, the "Get All" operation under the "Event" resource retrieves all calendar events from a specified calendar URL. This is useful for scenarios where you want to fetch and process all events from a user's calendar, such as syncing events into another system, generating reports, or displaying upcoming events in a custom dashboard.

For example, you might use this node to pull all events from a personal calendar URL like /calendars/user@example.com/personal/ and then filter or transform them downstream in your workflow.

Properties

Name Meaning
Calendar URL The URL path of the calendar collection to retrieve events from (e.g., /calendars/user@example.com/personal/). This must be provided to specify which calendar's events to fetch.

Output

The node outputs JSON data representing the list of calendar events retrieved from the specified calendar URL. Each event typically includes details such as start time, end time, summary, description, and other standard calendar event properties.

If the node supports binary data output (not evident from the provided code), it would likely relate to attachments or raw calendar data, but no explicit binary output handling is shown here.

Dependencies

  • Requires access to a CalDAV-compatible calendar server.
  • Needs an API key or authentication token configured in n8n to authenticate requests to the CalDAV server (the exact credential type is abstracted).
  • The user must provide the correct calendar URL path to target the desired calendar collection.

Troubleshooting

  • Common issues:
    • Incorrect or malformed calendar URL can lead to failure in fetching events.
    • Authentication errors if the API key or credentials are missing or invalid.
    • Network connectivity problems when reaching the CalDAV server.
  • Error messages:
    • Errors related to unauthorized access usually indicate missing or incorrect credentials.
    • Not found or 404 errors suggest the calendar URL does not exist or is inaccessible.
  • Resolutions:
    • Verify the calendar URL format and correctness.
    • Ensure valid credentials are set up in n8n.
    • Check network connectivity and CalDAV server availability.

Links and References

Discussion