Actions4
Overview
This node interacts with CalDAV servers to manage calendar events. Specifically, the "Get Single Event" operation retrieves a single event from a specified calendar using the event's unique identifier (UID). This is useful when you need to fetch detailed information about a particular calendar event, for example, to display event details in an application, synchronize events between systems, or trigger workflows based on specific event data.
Practical examples:
- Fetching a meeting's details by its UID to send reminders.
- Retrieving an event to update or analyze its properties.
- Integrating calendar events into other business processes by pulling event data dynamically.
Properties
| Name | Meaning |
|---|---|
| Calendar Name or ID | Select the calendar containing the event. You can choose from a list of available calendars or specify a calendar ID using an expression. |
| Selected Calendar Path Preview | Displays the currently selected calendar path for confirmation. Shown only if a calendar is selected. |
| Event UID | The unique identifier of the event to retrieve. This is required to specify exactly which event to fetch. |
Output
The node outputs a JSON object representing the retrieved calendar event. The structure includes all standard event details as provided by the CalDAV server, such as title, start and end times, description, location, attendees, and any other event metadata.
If the event is not found, the node throws an error indicating that the event with the specified UID does not exist.
No binary data output is involved in this operation.
Dependencies
- Requires access to a CalDAV server.
- Needs an API key credential configured in n8n to authenticate with the CalDAV service.
- Uses internal helper functions to load available calendars and perform the event retrieval.
Troubleshooting
Error: Event with UID '...' not found
This occurs if the specified event UID does not exist in the selected calendar. Verify the UID and calendar selection are correct.Empty or invalid calendar selection
Ensure that a valid calendar is selected or specified via expression; otherwise, the node cannot locate the event.Authentication issues
Confirm that the API key credential for the CalDAV server is correctly set up and has sufficient permissions.No fields returned or incomplete event data
This might be due to server-side restrictions or network issues. Check connectivity and server response.