CalDAV icon

CalDAV

Interact with CalDAV servers to manage calendar events
Join our community

Actions4

Overview

This node interacts with CalDAV servers to manage calendar events. Specifically, the "Create Event" operation allows users to add new events to a selected calendar on a CalDAV-compatible server. This is useful for automating calendar management tasks such as scheduling meetings, reminders, or any time-based event creation directly from workflows.

Practical examples include:

  • Automatically creating calendar events when a form is submitted.
  • Scheduling follow-up meetings after a sales call.
  • Adding reminders based on task deadlines in project management workflows.

Properties

Name Meaning
Calendar Name or ID Select the calendar to create the event in. Choose from a list of available calendars or specify an ID using an expression.
Selected Calendar Path Preview Displays the currently selected calendar path for confirmation (read-only notice).
Title The title or summary of the event.
Start Date Time The start date and time of the event.
End Date Time The end date and time of the event.
Additional Fields Optional additional settings for the event:
- All Day Event: Whether the event lasts all day (true/false).
- Description: Text description of the event.
- Location: Physical or virtual location of the event.

Output

The node outputs a JSON object representing the created event. This includes all the details of the event as stored on the CalDAV server, such as its unique identifier, title, start and end times, description, location, and other metadata.

No binary data output is produced by this operation.

Dependencies

  • Requires access to a CalDAV server with appropriate credentials (an API key or authentication token).
  • The node depends on the calDavApi credential configured in n8n to authenticate requests.
  • Uses internal helper functions to interact with the CalDAV server and handle event creation.

Troubleshooting

  • Common issues:

    • Invalid calendar ID or name: Ensure the calendar exists and the correct identifier is used.
    • Authentication failures: Verify that the CalDAV credentials are correctly set up and have sufficient permissions.
    • Date/time format errors: Confirm that start and end date-times are valid and the end is not before the start.

  • Error messages:

    • "Event with UID '...' not found": Occurs if trying to get or update an event that does not exist. For creation, this should not appear.
    • "At least one field must be specified for update": Relevant for update operations; ensure at least one property is provided.

To resolve errors, double-check input parameters, calendar selection, and credentials.

Links and References

Discussion