Zoho Calendar icon

Zoho Calendar

Consume Zoho Calendar API

Overview

This node interacts with the Zoho Calendar API to manage calendar events, specifically supporting the update operation for events. It allows users to update details of an existing event in a selected calendar, such as the event's title, start and end times, all-day status, color, description, location, privacy status, attendees, free/busy schedule visibility, and forwarding permissions. This node is useful for automating calendar management tasks, such as modifying event details based on workflow triggers or user inputs.

Use Case Examples

  1. Updating an event's title and time in a specific calendar.
  2. Changing the color and description of an existing event.
  3. Modifying attendees and privacy settings of a calendar event.

Properties

Name Meaning
Calendar The calendar in which the event to be updated exists. This is required to identify the calendar context for the event.
Event The specific event to update within the selected calendar. This is required to identify which event to modify.
Title The new title or name for the event. This is required to update the event's main label.
Start time The new start date and time for the event. This is required to set when the event begins.
End time The new end date and time for the event. This is required to set when the event ends.
Is an all-day event? Boolean flag indicating if the event lasts all day. Adjusts how start and end times are handled.
Color Preferred color for the event to visually distinguish it in the calendar.
Description Text description or notes about the event.
Location Physical or virtual location of the event.
Is a private event? Boolean flag indicating if the event is private.
Attendees Comma-separated list of attendees for the event.
Add to free/busy schedule Indicates if the event should be shown as busy or free in the calendar's free/busy schedule.
Allow to be forwarded by attendees? Boolean flag indicating if attendees are allowed to forward the event invitation.

Output

JSON

  • events - Array of updated event objects returned from the Zoho Calendar API after the update operation.

Dependencies

  • Zoho Calendar API
  • OAuth2 API key credential for Zoho Calendar

Troubleshooting

  • Ensure the calendar_id and event ID are valid and exist in the user's Zoho Calendar account to avoid errors.
  • Check that the OAuth2 credentials for Zoho Calendar are correctly configured and have the necessary permissions.
  • If the event update fails, verify that the 'etag' value used for concurrency control is current by fetching the latest event details before updating.
  • Common error messages may include authentication failures, invalid event or calendar IDs, or conflicts due to outdated 'etag' values. Refresh credentials or re-fetch event details to resolve these.

Links

Discussion