Actions7
Overview
This node integrates with Zoho Calendar to create new calendar events. It allows users to specify event details such as title, start and end times, timezone, description, location, attendees, and other optional settings. This node is useful for automating calendar management tasks like scheduling meetings, reminders, or any event creation directly from workflows.
Practical examples include:
- Automatically creating calendar events when a form is submitted.
- Scheduling follow-up meetings after a sales call.
- Adding reminders for project deadlines based on task completion in other systems.
Properties
| Name | Meaning |
|---|---|
| Calendar UID | The unique identifier of the calendar where the event will be created. |
| Event Title | The title or name of the event to be added. |
| Start Time | The starting date and time of the event. |
| End Time | The ending date and time of the event. |
| Time Zone | The time zone in which the event times are specified. Defaults to the current system time zone if not set. |
| Event Description | A detailed description of the event. Supports HTML line breaks using <br>. |
| Additional Fields | A collection of optional fields: |
| - Is All Day Event? | Boolean indicating if the event lasts all day (no specific start/end times). |
| - Is Private? | Boolean indicating if the event details should remain private even if the calendar is shared publicly or with others (except delegates). |
| - URL To Attached | A URL link attached to the event, e.g., a meeting link. |
| - Location | The physical or virtual location of the event. Can be an address or coordinates. |
| - Color | The color assigned to the event for visual distinction. |
| - Show On Free/Busy Schedule | Numeric flag (0 or 1) controlling whether the event appears on free/busy schedules. 0 means it shows, 1 means it does not. |
| - Attendees | List of attendees invited to the event, each specified by their email address. Multiple attendees can be added. |
Output
The node outputs a JSON object under the field json.zohoResponse containing the response from the Zoho Calendar API after creating the event. This typically includes details about the newly created event such as its ID, status, and other metadata returned by Zoho.
No binary data output is produced for 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?for event creation. - Relies on the
moment-timezonelibrary for handling date/time and timezone conversions internally.
Troubleshooting
- Missing Required Fields: Ensure that required properties like Calendar UID, Event Title, Start Time, End Time, and Time Zone are provided. Missing these will cause errors.
- Invalid Time Ranges: The start time must be before the end time; otherwise, the node throws an error.
- All Day Event Restrictions: When setting an event as all-day, start and end times must be formatted accordingly. Changing an event from all-day to timed without specifying times may cause errors.
- API Authentication Errors: If the OAuth2 token is invalid or expired, requests will fail. Re-authenticate the credential in n8n.
- Attendee Email Validation: Attendees must have valid email addresses; missing or malformed emails may cause API rejection.
- Time Zone Issues: Invalid or unsupported time zones can cause failures. Use standard time zone identifiers.