CalDAV icon

CalDAV

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

Actions15

Overview

The node's execute() method for the Calendar resource with the Create operation is designed to create a new calendar in a CalDAV-compatible service. It allows users to specify key details such as the calendar's unique identifier, display name, description, and color. This node is beneficial when automating calendar management tasks, such as setting up new calendars for different projects, teams, or personal use within workflows.

Practical examples include:

  • Automatically creating a project-specific calendar when a new project is initiated.
  • Setting up personal or shared calendars with predefined colors and descriptions for better organization.
  • Integrating calendar creation into onboarding workflows to provision calendars for new employees.

Properties

Name Meaning
Calendar Name The display name of the calendar that will be shown to users.
Calendar ID A unique identifier for the new calendar; used internally to reference the calendar.
Description A brief description of the calendar’s purpose or contents.
Color The calendar’s color represented in hexadecimal format (e.g., #3174ad) for UI display.

Output

The output JSON contains information about the newly created calendar. This typically includes fields such as the calendar's unique identifier, display name, description, color, and possibly metadata returned by the CalDAV server confirming the creation. The exact structure depends on the CalDAV service response but generally provides confirmation and details of the created calendar.

No binary data output is expected from this operation.

Dependencies

  • Requires access to a CalDAV-compatible calendar service.
  • Needs appropriate API credentials or authentication tokens configured in n8n to authorize calendar creation requests.
  • Network connectivity to the CalDAV server must be established.

Troubleshooting

  • Common Issues:

    • Invalid or missing Calendar ID or Calendar Name can cause the creation to fail.
    • Authentication errors if API credentials are incorrect or expired.
    • Network issues preventing connection to the CalDAV server.
    • Color value not in proper hex format may be rejected by the server.

  • Error Messages:

    • "Authentication failed" — Verify API credentials and permissions.
    • "Calendar ID already exists" — Use a unique Calendar ID.
    • "Invalid color format" — Ensure the color is a valid hex string like #3174ad.
    • "Network error" — Check internet connection and CalDAV server availability.

Resolving these usually involves verifying input properties, checking credentials, and ensuring network stability.

Links and References

Discussion