CalDAV icon

CalDAV

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

Actions15

Overview

This node is designed to delete an event from a calendar using the CalDAV protocol. It targets a specific calendar collection identified by its URL and removes an event specified by its unique identifier (UID). This operation is useful in scenarios where users need to programmatically manage their calendar events, such as removing outdated or canceled appointments automatically.

Practical examples include:

  • Automatically deleting events that have been canceled in an external system.
  • Cleaning up test or temporary events after certain workflows complete.
  • Synchronizing event deletions between different calendar services.

Properties

Name Meaning
Calendar URL The URL path of the calendar collection where the event resides. Example: /calendars/user@example.com/personal/
Event UID The unique identifier of the event to be deleted. Example: event-12345@example.com

Output

The node outputs JSON data representing the result of the delete operation. Typically, this will confirm whether the deletion was successful or provide error details if it failed. There is no indication that binary data is output by this node.

Dependencies

  • Requires access to a CalDAV-compatible calendar server.
  • Needs appropriate API authentication credentials (e.g., an API key or token) configured in n8n to authorize requests against the calendar server.
  • The user must provide the correct calendar URL and event UID for the deletion to succeed.

Troubleshooting

  • Common issues:

    • Incorrect or malformed Calendar URL can cause the node to fail to locate the calendar collection.
    • Providing an invalid or non-existent Event UID will result in failure to delete the event.
    • Authentication errors if the API credentials are missing, expired, or incorrect.
    • Network connectivity problems with the CalDAV server.

  • Error messages and resolutions:

    • "Event not found" — Verify the Event UID is correct and exists in the specified calendar.
    • "Unauthorized" or "Authentication failed" — Check that the API credentials are properly set up and valid.
    • "Invalid calendar URL" — Ensure the Calendar URL matches the expected format and points to an existing calendar collection.

Links and References

Discussion