CalDAV icon

CalDAV

CalDAV Node

Actions4

Overview

This node is designed to update an existing calendar event using the CalDAV protocol. It allows users to modify key details of an event such as its summary, start and end times, location, description, and additional metadata. This node is beneficial in scenarios where calendar events need to be programmatically updated based on external triggers or workflows, for example, syncing event changes from another system or adjusting event details dynamically.

Practical examples include:

  • Automatically updating meeting times when a related project deadline shifts.
  • Changing event locations based on user preferences or availability.
  • Adding or modifying event descriptions with additional context or notes.

Properties

Name Meaning
Event Summary The title or summary of the event.
Event Start The starting date and time of the event.
Event End The ending date and time of the event (optional).
Location The physical or virtual location where the event will take place (optional).
Description Additional details or notes about the event (optional).
Event Metadata JSON object containing extra metadata related to the event.

Output

The node outputs JSON data representing the updated event details after the operation completes. This typically includes the updated fields such as summary, start and end times, location, description, and any metadata. There is no indication that binary data is output by this node.

Dependencies

  • Requires an API key credential for authenticating with the CalDAV service.
  • Needs proper configuration of the CalDAV connection within n8n to access the calendar server.
  • Relies on the CalDAV protocol and the corresponding calendar server supporting event updates.

Troubleshooting

  • Common Issues:

    • Authentication failures due to incorrect or missing API credentials.
    • Invalid date/time formats causing the update to fail.
    • Attempting to update an event that does not exist or has been deleted.
    • Insufficient permissions on the calendar server to modify events.
  • Error Messages and Resolutions:

    • Authentication error: Verify that the API key or authentication token is correctly configured and has necessary permissions.
    • Invalid date format: Ensure that the "Event Start" and "Event End" properties are provided in a valid ISO 8601 datetime format.
    • Event not found: Confirm the event ID exists and is accessible with the current credentials.
    • Permission denied: Check user permissions on the calendar server and adjust accordingly.

Links and References

Discussion