CalDAV icon

CalDAV

Interact with CalDAV servers for calendar operations
Join our community

Actions5

Overview

This node integrates with CalDAV servers to perform calendar operations such as retrieving calendars, fetching events, creating, updating, and deleting events. Specifically, the Update Event operation allows users to update an existing calendar event by providing its unique identifier and new event data in iCalendar (.ics) format.

Common scenarios for this node include synchronizing calendar events from external systems, automating updates to scheduled meetings or appointments, and managing calendar data programmatically within workflows.

For example, you can use this node to update a meeting's time or description on your CalDAV-compatible calendar server whenever related data changes in another system.

Properties

Name Meaning
Calendar Name or ID Select the calendar to update the event in, either by choosing from a list of available calendars or specifying a calendar ID/path manually (server-relative path starting with "/").
Event ID The unique identifier of the event to update.
Event Data (iCalendar) The updated event details formatted as an iCalendar (.ics) string. This contains all event information such as start/end times, summary, attendees, etc.

Output

The node outputs a JSON object containing:

  • success (boolean): Indicates whether the update operation was successful (HTTP status code 2xx).
  • statusCode (number): The HTTP response status code returned by the CalDAV server.
  • eventId (string): The identifier of the updated event.
  • calendarPath (string): The server-relative path of the calendar where the event was updated.

No binary data output is produced by this operation.

Dependencies

  • Requires connection to a CalDAV server with valid credentials including a base URL and authentication token.
  • The base URL must include the protocol (http:// or https://) and be correctly configured in the node credentials.
  • The node uses HTTP methods like PUT with appropriate headers (Content-Type: text/calendar, If-Match: *) to interact with the CalDAV API.

Troubleshooting

  • Invalid Base URL: If the base URL in credentials is missing or does not start with http:// or https://, the node will throw an error. Ensure the URL includes the protocol and is correct.
  • Absolute URLs in paths: Paths for calendar or event must be server-relative (start with /). Absolute URLs are rejected.
  • Connection errors:
    • ENOTFOUND: Hostname not found; verify server address.
    • ECONNREFUSED: Connection refused; check if the server is reachable and port is open.
    • ETIMEDOUT: Connection timed out; network issues or slow server.
  • HTTP errors: Non-2xx responses indicate failure. The node surfaces HTTP status codes and messages to help diagnose issues.
  • Malformed iCalendar data: Providing invalid .ics content may cause the server to reject the update. Validate the iCalendar format before sending.

Links and References

Discussion