CalDAV icon

CalDAV

Interact with CalDAV servers to manage calendars, events, todos, and free/busy information

Actions15

Overview

The node provides functionality to create a new todo item in a calendar or task collection using a CalDAV-compatible service. It is useful for automating task management workflows, such as adding reminders, setting deadlines, or tracking progress on projects within calendar applications that support the CalDAV protocol.

Practical examples include:

  • Automatically creating tasks from form submissions or issue trackers.
  • Scheduling reminders based on external triggers.
  • Integrating with project management tools to sync todos.

Properties

Name Meaning
Calendar URL The URL path of the calendar or task collection where the todo will be created.
Summary (Title) The title or summary text of the todo item.
Description A detailed description providing more context about the todo.
Priority The priority level of the todo; options are High (1), Medium (5), and Low (9).
Status The current status of the todo; options include Needs Action, In Progress, Completed, and Cancelled.
Due Date The date and time when the todo is due.
Progress Percentage The completion percentage of the todo, ranging from 0 to 100.

Output

The node outputs JSON data representing the created todo item. This typically includes details such as the unique identifier of the todo, its summary, description, status, priority, due date, and progress percentage. The output can be used downstream in workflows for further processing or logging.

No binary data output is indicated.

Dependencies

  • Requires access to a CalDAV-compatible calendar or task service.
  • An API key or authentication token configured in n8n to authorize requests to the CalDAV server.
  • Properly formatted Calendar URL pointing to the target calendar/task collection.

Troubleshooting

  • Invalid Calendar URL: Ensure the Calendar URL is correct and accessible. Incorrect URLs will cause failures in creating the todo.
  • Authentication Errors: Verify that the API credentials or tokens are valid and have sufficient permissions.
  • Invalid Property Values: For example, ensure the due date is in a valid datetime format and the progress percentage is between 0 and 100.
  • Network Issues: Connectivity problems with the CalDAV server may cause timeouts or errors.

Common error messages might include authorization failures, resource not found, or validation errors on input fields. Resolving these usually involves checking credentials, URLs, and input formats.

Links and References

Discussion