CalDAV icon

CalDAV

Interact with CalDAV servers to manage calendar events

Overview

This node interacts with CalDAV servers to manage calendar events, specifically allowing users to update existing events in a selected calendar. It is useful for automating calendar management tasks such as modifying event details without manually accessing the calendar application.

Typical use cases include:

  • Updating event titles, descriptions, or locations based on external triggers.
  • Changing event start and end times programmatically.
  • Marking events as all-day or adjusting their timing dynamically.

For example, you could use this node to automatically update meeting details when a related CRM record changes or to adjust event times based on timezone conversions.

Properties

Name Meaning
Calendar Name or ID Select the calendar containing the event to update. Choose from a list or specify an ID via expression.
Selected Calendar Path Preview Displays the currently selected calendar path for confirmation (read-only notice).
Event UID The unique identifier of the event to update.
Update Fields Collection of fields to update on the event. At least one must be specified. Options include:
- All Day Event Boolean indicating whether the event is an all-day event.
- Description Text description of the event.
- End Date Time The new end date and time of the event.
- Location The location of the event.
- Start Date Time The new start date and time of the event.
- Title The title or summary of the event.

Output

The node outputs JSON data representing the updated event object returned from the CalDAV server. This includes all relevant event properties after the update has been applied.

No binary data output is produced by this node.

Dependencies

  • Requires access to a CalDAV server with appropriate credentials configured in n8n.
  • Needs an API key or authentication token credential for the CalDAV service.
  • Uses internal helper functions to interact with the CalDAV API, including fetching calendars and updating events.

Troubleshooting

  • Error: "At least one field must be specified for update"
    Occurs if no update fields are provided. To fix, ensure you specify at least one property to update in the "Update Fields" collection.

  • Error: "Event with UID '...' not found"
    Happens if the specified event UID does not exist in the selected calendar. Verify the event UID and calendar selection.

  • Authentication issues
    Ensure that the CalDAV credentials are correctly set up and have sufficient permissions to modify events.

  • Invalid date/time formats
    Make sure the start and end date/time values are valid ISO 8601 strings or compatible date-time inputs.

Links and References

Discussion