Actions9
Overview
This node integrates with Nextcloud's CalDAV calendar system to manage calendars and events. Specifically, the "Kalender Erstellen" (Calendar Create) operation allows users to create a new calendar in their Nextcloud account.
Typical use cases include:
- Automating the creation of new project or team calendars when onboarding new projects.
- Dynamically generating calendars for different departments or clients.
- Setting up personalized calendars with specific colors and descriptions for better organization.
For example, a user can create a calendar named "Marketing Campaigns" with a blue color and a description explaining its purpose, all automatically via this node.
Properties
| Name | Meaning |
|---|---|
| Kalender Name | The name of the new calendar to be created. This is a required string input. |
| Kalender Einstellungen | A collection of optional settings for the calendar: |
| - Farbe | The color of the calendar as displayed in the user interface. Default is #0082C9. |
| - Beschreibung | A textual description of the calendar, which can help identify its purpose or contents. |
Output
The output JSON contains an array of results, each representing the outcome of the create operation. For a successful calendar creation, the output includes:
success: Boolean indicating if the operation was successful (true).operation: The operation performed, here"create".resource: The resource type, here"calendar".message: A success message, e.g.,"Kalender erfolgreich erstellt".data: An object containing details of the newly created calendar as returned by the Nextcloud API. This typically includes properties like the calendar's display name and URL.
No binary data output is produced by this operation.
Example output snippet:
[
{
"success": true,
"operation": "create",
"resource": "calendar",
"message": "Kalender erfolgreich erstellt",
"data": {
"displayName": "Marketing Campaigns",
"url": "/calendars/user/marketing-campaigns/"
}
}
]
Dependencies
- Requires a valid connection to a Nextcloud instance with CalDAV enabled.
- Needs an API authentication token or credentials configured in n8n to access the Nextcloud Calendar API.
- The node depends on internal helper modules that handle communication with the Nextcloud CalDAV server.
Troubleshooting
Common issues:
- Authentication failures due to invalid or missing API credentials.
- Network connectivity problems preventing access to the Nextcloud server.
- Invalid calendar names or settings causing the API to reject the request.
Error messages:
- If the calendar cannot be created, the node will throw an error with a message such as
"Kalender konnte nicht erstellt werden"(not shown explicitly in code but implied by failure). - Errors related to invalid input parameters will be raised as node operation errors.
- If the calendar cannot be created, the node will throw an error with a message such as
Resolution tips:
- Verify that the API credentials are correctly set up and have sufficient permissions.
- Ensure the Nextcloud server URL is reachable from the n8n environment.
- Check that the calendar name is unique and valid according to Nextcloud's requirements.