Zoho Calendar icon

Zoho Calendar

Community Node for Zoho Calendar

Overview

This node updates an existing event in a specified calendar within Zoho Calendar. It allows users to modify various aspects of the event such as its title, start and end times, time zone, description, privacy settings, location, color, visibility on free/busy schedules, attached URLs, and attendees.

Common scenarios where this node is beneficial include:

  • Adjusting meeting times or details after scheduling.
  • Correcting event information like location or description.
  • Changing event privacy or visibility settings.
  • Adding or updating attendees for an event.
  • Updating event metadata without recreating the event.

For example, you might use this node to update a team meeting's start time and add new participants after receiving feedback from attendees.

Properties

Name Meaning
Calendar UID The unique identifier (UID) of the calendar containing the event to update.
Event UID The unique identifier (UID) of the event to update within the specified calendar.
Update Event Title New title for the event. Leave blank to keep the original title.
Change Start Time New start time for the event. Leave blank to keep the current start time.
Change End Time New end time for the event. Leave blank to keep the current end time.
Time Zone Updated time zone for the event. Leave blank to keep the current time zone. If changed without providing new start/end times, the existing event times will be converted to the new time zone.
Event Description Updated description of the event. Supports HTML line breaks using <br>.
Additional Fields Collection of optional fields:
- Is All Day Event? Boolean indicating if the event lasts all day. Note: changing from all-day to timed event requires specifying new start and end times.
- Is Private? Boolean indicating if the event details should remain private even when the calendar is shared publicly or with others (except delegates).
- URL To Attached A URL to attach to the event (e.g., a meeting link).
- Location Location of the event; can be an address or coordinates.
- Color Color assigned to the event for visual identification.
- Show On Free/Busy Schedule Numeric flag (0 or 1) controlling whether the event appears on free/busy schedules. 0 means it is shown; 1 means it is hidden.
- Attendees List of attendees invited to the event. Each attendee requires an email address.

Output

The node outputs a JSON object under the field json.zohoResponse which contains the response from the Zoho Calendar API after attempting to update the event. This typically includes updated event details or status confirmation.

No binary data output is produced by this operation.

Dependencies

  • Requires an authenticated connection to Zoho Calendar via OAuth2 credentials.
  • Uses the Zoho Calendar API endpoint for updating events.
  • Relies on moment-timezone library for date/time manipulation and validation.
  • Requires proper configuration of the OAuth2 credential in n8n to authorize API requests.

Troubleshooting

  • Error when changing all-day event to non-all-day without specifying times: The API throws an error if you try to switch an event from all-day to timed without providing new start and end times. Always specify both times when making this change.
  • Invalid or missing calendar/event UIDs: Ensure that the provided calendar and event UIDs are correct and exist in your Zoho Calendar account.
  • Time zone conversion issues: If you change the time zone without updating start/end times, the node converts existing times to the new zone. Verify that this behavior matches your expectations.
  • API authentication errors: Confirm that the OAuth2 credentials are valid and have sufficient permissions to update events.
  • Attendee email validation: Attendee emails must be valid strings; invalid emails may cause request failures.

Links and References

Discussion