Actions9
Overview
This node allows managing calendar events within a Nextcloud Calendar via CalDAV. Specifically, the "Termin Ändern" (Update Event) operation lets users modify existing calendar events by changing details such as title, start and end times, location, description, attendees, and notification settings.
Common scenarios include:
- Updating meeting details when plans change.
- Correcting event information like time or location.
- Adding or removing participants from an event.
- Enabling or disabling notifications for attendees.
Practical example: You have scheduled a team meeting but need to update the start time and add a new participant. Using this node, you can specify the event ID and calendar, provide the new start time, and add the participant's email and role, then send updated invitations automatically.
Properties
| Name | Meaning |
|---|---|
| Kalender | Select a calendar by name or enter its ID where the event exists. |
| Termin ID | The unique identifier of the event to update. |
| Update Fields | Collection of fields to update in the event: - Titel: New event title. - Start: New start date/time. - Ende: New end date/time. - Ort: New location. - Beschreibung: New description. |
| Einladungen Aktivieren | Boolean flag to decide whether to send invitations to attendees after updating the event. |
| Teilnehmer | List of attendees to add or update, each with: - E-Mail: Attendee's email address (required). - Anzeigename: Display name. - RSVP: Whether a response is expected. - Rolle: Role in event (Required, Optional, Organizer). |
| Nextcloud Einstellungen | Additional Nextcloud-specific settings: - Alarm-Typ Erzwingen: Force alarm type (Email or Display). - Benachrichtigungen Aktivieren: Enable notifications. - Export Ausblenden: Hide export buttons. - Push-Benachrichtigungen Aktivieren: Enable push notifications. |
Output
The node outputs an array of JSON objects representing the result of the update operation. Each object includes:
success: Boolean indicating if the update was successful.operation: The performed operation ("update").resource: The resource type ("event").message: A human-readable status message.data: The updated event data parsed from the Nextcloud response, containing updated event details such as title, start/end times, location, description, attendees, and notification settings.
No binary data output is produced by this operation.
Dependencies
- Requires connection to a Nextcloud instance with CalDAV support.
- Needs an API key credential configured in n8n for authenticating with the Nextcloud Calendar API.
- Relies on internal helper modules for interacting with Nextcloud calendars and events.
Troubleshooting
- Invalid Email Address Error: If any attendee email is invalid (not matching standard email format), 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. Verify the date/time inputs.
- Event Not Found: If the specified event ID does not exist in the selected calendar, an error is thrown indicating the event could not be found.
- No Response from Server: If the Nextcloud server does not respond or returns invalid data, the node will throw an error about no response or invalid response.
- Permission Issues: Make sure the API credentials have sufficient permissions to update events in the target calendar.
- Continue On Fail: If enabled, the node will continue processing other items even if one fails, returning error details per item.