Actions7
Overview
This node interacts with Zoho Calendar to retrieve a list of events from a specified calendar within a given date-time range. It is useful for scenarios where you want to fetch all calendar events occurring between two dates, such as generating reports, syncing events with other systems, or displaying upcoming events in an application.
For example, you could use this node to:
- Get all events scheduled in a team calendar for the next week.
- Retrieve events within a specific month to analyze meeting frequency.
- Sync events from Zoho Calendar into another calendar system or database.
Properties
| Name | Meaning |
|---|---|
| Calendar UID | The unique identifier (UID) of the calendar from which to retrieve events. |
| Start Of Search Range | The start date and time defining the beginning of the search range for events (max 31 days). |
| End Of Search Range | The end date and time defining the end of the search range for events (max 31 days). |
| Time Zone | The time zone context for the event times; defaults to the current system time zone. |
Output
The output JSON contains a field named zohoResponse which holds the response data returned by 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 the calendar UID, start, or end date-times are missing or invalid, the node will throw errors. Double-check these inputs before execution.
- 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 result in rate limiting. Implement retry logic or reduce request frequency if necessary.