Zoho Calendar icon

Zoho Calendar

Community Node for Zoho Calendar

Actions7

Event → Get Events List

AI-generated

Overview

This node interacts with Zoho Calendar to retrieve a list of events from a specified calendar within a defined date-time range. It is useful for scenarios where you need to fetch and process calendar events programmatically, such as syncing events with other systems, generating reports, or triggering workflows based on upcoming events.

For example, you can use this node to:

  • Retrieve all events scheduled in a particular calendar over the next week.
  • Filter events by time zone to handle users across different regions.
  • Automate reminders or notifications based on event data fetched from Zoho Calendar.

Properties

Name Meaning
Calendar UID The unique identifier (UID) of the calendar from which to fetch events.
Start Of Search Range The start date and time defining the beginning of the search window for events (max 31 days).
End Of Search Range The end date and time defining the end of the search window for events (max 31 days).
Time Zone The time zone context for interpreting the event times. Defaults to the current system time zone.

Output

The output JSON contains a field named zohoResponse which holds the response from the Zoho Calendar API for the requested events list. This typically includes an array of event objects with details such as event titles, start and end times, descriptions, attendees, and other metadata.

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: https://calendar.zoho.com/api/v1/calendars/{calendarId}/events
  • Relies on moment-timezone library for date-time manipulation and validation.
  • The node expects proper configuration of the OAuth2 credential in n8n to authorize API requests.

Troubleshooting

  • Date Range Errors: The node enforces that the search range must be under 31 days. Providing a longer range will cause an error. Ensure your start and end dates are within this limit.
  • Missing Required Fields: If required properties like Calendar UID, Start Of Search Range, or End Of Search Range are missing or invalid, the node will throw errors. Double-check these inputs.
  • Time Zone Issues: Incorrect or unsupported time zone strings may cause unexpected results or errors. Use valid IANA time zone names or rely on the default.
  • Authentication Failures: If the OAuth2 credentials are not set up correctly or have expired, API calls will fail. Re-authenticate or update credentials as needed.
  • API Rate Limits: Excessive requests to Zoho Calendar API might lead to rate limiting. Implement retry logic or reduce request frequency if encountering HTTP 429 errors.

Links and References

Discussion