CalDAV icon

CalDAV

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

Actions15

Overview

The node provides functionality to update calendar details via a CalDAV-compatible service. It allows users to modify properties of an existing calendar such as its display name, description, and color by specifying the calendar's URL path. This is useful in scenarios where you want to programmatically manage calendar metadata, for example, renaming a calendar or changing its color coding to better organize events.

Practical examples include:

  • Updating a personal calendar's name and description after rebranding.
  • Changing the color of a shared team calendar to improve visual distinction in calendar clients.

Properties

Name Meaning
Calendar URL The URL path identifying the calendar collection to update (e.g., /calendars/user@example.com/personal/). This is required to locate the calendar resource.
Calendar Name The new display name for the calendar.
Description A textual description of the calendar’s purpose or contents.
Color The calendar color represented as a hex code (e.g., #3174ad), used for UI display.

Output

The node outputs JSON data representing the updated calendar object. This typically includes the updated properties such as the calendar URL, display name, description, and color. There is no indication that binary data is output by this node.

Dependencies

  • Requires access to a CalDAV-compatible calendar server.
  • Needs appropriate authentication credentials (such as an API key or token) configured in n8n to authorize requests to the calendar service.
  • The node relies on internal operation execution logic imported from bundled dependencies but does not specify external libraries beyond that.

Troubleshooting

  • Invalid Calendar URL: If the provided calendar URL is incorrect or does not exist, the update will fail. Verify the URL path carefully.
  • Authentication Errors: Missing or invalid credentials will prevent successful updates. Ensure the API key or authentication token is correctly set up.
  • Permission Denied: The user associated with the credentials may lack permission to update the specified calendar.
  • Invalid Color Format: The color property must be a valid hex color code; otherwise, the update might be rejected.
  • Empty Required Fields: Required fields like Calendar URL and Calendar Name must be provided; missing these will cause errors.

Links and References

Discussion