Actions9
Overview
This node integrates with Nextcloud Calendar via CalDAV to manage calendar events. Specifically, the "Termin Erstellen" (Create Event) operation allows users to create new calendar events in a selected Nextcloud calendar. It supports setting event details such as title, start and end times, description, location, attendees, and invitation sending.
Common scenarios where this node is beneficial include automating event creation from other workflows, syncing external scheduling data into Nextcloud, or programmatically managing team calendars.
Practical example: Automatically creating a meeting event in a shared Nextcloud calendar when a form is submitted or a task is created in another system.
Properties
| Name | Meaning |
|---|---|
| Kalender | Select a calendar by name or ID where the event will be created. |
| Titel | Title of the event. |
| Start | Start date and time of the event. Defaults to current time. |
| Ende | End date and time of the event. Must be after the start time. Defaults to one hour after start. |
| Beschreibung | Description text for the event. |
| Ort | Location of the event. |
| Einladungen Aktivieren | Boolean flag whether to send invitations to attendees. |
| Teilnehmer | Collection of attendees to add to the event. Each attendee includes: |
| - E-Mail (required, must be valid email format) | |
| - Anzeigename (display name) | |
| - RSVP (boolean, whether response is expected) | |
| - Rolle (role in event: Required participant, Optional participant, Organizer) | |
| Nextcloud Einstellungen | Additional Nextcloud-specific settings for the event, including: |
| - Alarm-Typ Erzwingen (force alarm type: Email or Display) | |
| - Benachrichtigungen Aktivieren (enable notifications) | |
| - Export Ausblenden (hide export buttons in UI) | |
| - Push-Benachrichtigungen Aktivieren (enable push notifications) |
Output
The node outputs an array of JSON objects representing the result of the event creation operation. Each output item contains:
success: Boolean indicating if the operation succeeded.operation: The operation performed ("create").resource: The resource type ("event").message: A success message string.data: The detailed event object returned from Nextcloud, containing all event properties including attendees and metadata.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a Nextcloud instance with CalDAV calendar API enabled.
- Needs an API authentication credential configured in n8n to access the Nextcloud Calendar API.
- Relies on internal helper modules for interacting with Nextcloud and parsing responses.
Troubleshooting
- Invalid Email Address: If any attendee email is missing or invalid, the node throws an error specifying the problematic email. Ensure all attendee emails are correctly formatted.
- End Time Before Start Time: The node validates that the event's end time is after the start time. If not, it throws an error. Adjust the times accordingly.
- No Response from Server: If the Nextcloud server does not respond or returns no data upon event creation, an error is thrown. Check network connectivity and API credentials.
- Missing Required Fields: The calendar selection, title, start, and end times are required. Omitting these will cause errors.
- Permission Issues: If the API user lacks permission to create events in the specified calendar, the operation will fail. Verify user rights in Nextcloud.