Actions9
Overview
This node integrates with Nextcloud Calendar via CalDAV to manage calendars and events. It allows users to create, retrieve, update, delete, and search for calendar events within specified Nextcloud calendars. The node is useful for automating calendar management tasks such as scheduling meetings, fetching upcoming events, or synchronizing calendar data between Nextcloud and other systems.
Practical examples include:
- Automatically creating a meeting event in a specific Nextcloud calendar when a form is submitted.
- Retrieving details of a particular event by its ID.
- Searching for events containing certain keywords within a date range.
- Fetching the next upcoming events from a calendar for notification purposes.
Properties
| Name | Meaning |
|---|---|
| Kalender | Select a calendar from the list or enter its ID manually. This determines which calendar to use. |
| Termin ID | The unique identifier of an event (appointment) within the selected calendar. Required for operations that target a specific event like get, update, or delete. |
The "Kalender" property supports two input modes:
- List: Choose from a searchable list of available calendars.
- ID: Enter the calendar ID directly as a string.
Output
The node outputs an array of JSON objects, each representing the result of an operation on calendars or events. Each output item includes:
success: Boolean indicating if the operation succeeded.operation: The performed operation name (e.g., "get", "create", "delete").resource: The resource type ("calendar" or "event").message: A human-readable message describing the outcome.data: The detailed response data from Nextcloud, typically including calendar or event information.
For event-related operations, the data field contains parsed event details such as title, start/end times, description, location, attendees, etc.
No binary data output is produced by this node.
Dependencies
- Requires connection to a Nextcloud instance with CalDAV calendar support.
- Needs an API authentication credential configured in n8n to access the Nextcloud Calendar API.
- Relies on internal helper modules for calendar and event actions and response parsing.
Troubleshooting
- Invalid Calendar ID or Name: If the calendar cannot be found or accessed, verify the calendar identifier and ensure the API credentials have sufficient permissions.
- Event Not Found: When retrieving or deleting an event by ID, errors occur if the event does not exist or the ID is incorrect.
- Date Validation Errors: Creating or updating events requires the end time to be after the start time; otherwise, an error is thrown.
- Invalid Email Addresses: Attendee email addresses must be valid; invalid formats cause errors.
- No Response from Server: Network issues or misconfigured credentials can lead to no response errors.
- Empty Results: Searches or fetches may return empty arrays if no matching events are found.
To resolve these issues:
- Double-check calendar and event IDs.
- Validate date/time inputs.
- Ensure attendee emails are correctly formatted.
- Confirm API credentials and network connectivity.