CalDAV Node icon

CalDAV Node

Use a CalDAV Server

Actions4

Overview

The "Create Event" operation in the Calendar resource of this CalDAV node allows users to create new calendar events on a connected CalDAV server. This is useful for automating event scheduling workflows, such as adding meetings, reminders, or appointments directly into a specified calendar without manual entry.

Typical use cases include:

  • Automatically creating calendar events from form submissions or CRM data.
  • Scheduling reminders and notifications for upcoming tasks or deadlines.
  • Integrating with other systems to keep calendars synchronized.

For example, you could use this node to create a meeting event with a title, start/end times, location, and reminders that notify attendees 15 minutes before the event starts.

Properties

Name Meaning
Calendar Name or ID Select the target calendar by name or ID where the event will be created. You can choose from your connected account's calendars or specify a calendar URL/ID using an expression.
Event Title The main title or name of the event, displayed prominently in calendar views.
Is This an All-Day Event? Choose "Yes" if the event lasts the entire day(s) without specific start/end times; otherwise "No".
Event Start Date & Time The starting date and time of the event in RFC3339 format (e.g., "2024-03-20T15:00:00Z"). Times are stored in UTC.
Event End Date & Time The ending date and time of the event in RFC3339 format. Must be after the start time.
Event Reminders & Notifications Configure one or more reminders for the event. Each reminder specifies when it should trigger relative to the event time (e.g., 15 minutes before). Options include days/hours/minutes before or after the event.
Additional Event Parameters Optional extra details about the event:
- Description: Detailed info like agenda or notes.
- Location: Physical or virtual place (address, room, or meeting link).
- Status: Confirmed, Tentative, or Cancelled.
- Website URL: Link related to the event (e.g., meeting platform).
Additional Options Extra settings:
- Include Raw Calendar Data: Whether to output the full iCalendar (ICS) data.
- Include Server Response: Whether to include the complete server response for debugging or verification purposes.

Output

The node outputs JSON data representing the created calendar event. This typically includes:

  • Confirmation details of the newly created event.
  • Optionally, the raw iCalendar (ICS) data if enabled.
  • Optionally, the full server response if requested.

If reminders were set, these are included as part of the event data.

The output JSON structure corresponds to the standard calendar event representation returned by the CalDAV server, including fields like event ID, title, start/end times, status, location, description, and alarms.

No binary data output is indicated for this operation.

Dependencies

  • Requires connection to a CalDAV server with appropriate credentials (an API key or authentication token).
  • The node depends on the CalDAV protocol and server capabilities to create events.
  • Proper configuration of the CalDAV credentials in n8n is necessary.
  • The node uses internal methods to fetch available calendars dynamically for selection.

Troubleshooting

  • Invalid Date Format: Ensure that start and end dates are in valid RFC3339 format and that the end date is after the start date.
  • Authentication Errors: Verify that the CalDAV credentials are correctly configured and have permission to create events on the selected calendar.
  • Calendar Not Found: If specifying a calendar ID manually, ensure it exists and is accessible by the authenticated user.
  • Reminder Configuration Issues: When setting reminders, confirm that the trigger options and time units are valid and supported by the server.
  • Server Response Errors: Enabling the "Include Server Response" option can help debug issues by showing detailed error messages from the CalDAV server.

Links and References

Discussion