Zoho Calendar
Zoho Calendar is an online business calendar that makes scheduling easy for you. You can use it to stay on top of your schedule and also share calendars with your team to keep everyone on the same page.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Zoho Calendar |
| URL | https://www.zoho.com/calendar/contact.html |
| zmintegration@zohomail.com |
| Connector Metadata | |
|---|---|
| Publisher | Zoho Mail |
| Website | https://www.zoho.com/calendar/ |
| Privacy policy | https://www.zoho.com/privacy.html |
| Categories | Collaboration;Productivity |
Zoho Calendar
Zoho Calendar is an online business calendar that makes your scheduling effortless. Zoho Calendar connector gives you the power to manage your calendar and perform repetitive actions such as create, edit, delete event by creating workflows using action trigger model.
Prerequisites
A verified Zoho Calendar account. Click here to create your first account.
How to get credentials
When you create a new connection,
- Select the domain where your Zoho account resides.
- Enter your Zoho Calendar credentials.
- Even if the power app is shared with another user, they should create a new connection to start using it.
Zoho Calendar API uses OAuth2.0 to authenticate and hence no secondary authentication is required once the account has been set up.
Get started with your connector
Follow the steps below to connect to Zoho Calendar :
- Login to your Power Automate account and click Create from the left menu.
- You can choose to create a cloud flow, desktop flow, or business flow. To connect to Zoho Calendar, choose the automated cloud flow.
- You can create a flow/template.
- Enter the desired values for the respective action.
Known Issues and Limitations
- Currently, Recurring events are not supported in the connector.
Common errors and remedies
- To avoid authentication errors, choose the domain where your Zoho Calendar account is hosted.
FAQ
https://www.zoho.com/calendar/help/getting-started.html
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| Select the region where your Zoho account data resides. | string | Select the domain. | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Create new event |
Adds a new event to the user's calendar. |
| Delete event |
Deletes an event from the user's calendar. |
| Get calendar details |
retrieves the details of a particular calendar using the Calendar UID. |
| Get calendar list |
Gets the list of all calendars with the calendar UID, name, and timezone. |
| Get event |
Gets the details of a particular event such as the event title, start date, end date, etc., from a user's specified calendar. |
| Get Event list |
Gets the list of all the events between the specified date range in yyyy-MM-ddTHH:mm:sszzz format. |
| Search Events |
Gets the list of events across all calendars. |
| Update Event |
Updates an existing event in a user's calendar. |
Create new event
Adds a new event to the user's calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
Title
|
title | True | string |
Specify the event title |
|
Start time
|
start | True | string |
Specify the event start time in the format yyyy-MM-ddTHH:mm:sszzz |
|
End time
|
end | True | string |
Specify the event end time in the format yyyy-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Specify the event's timezone |
|
|
Color
|
color | string |
Choose the event color or specify the color's hexdecimal value |
|
|
Description
|
description | string |
Specify the description of the event |
|
|
Location
|
location | string |
Specify the location of the event |
|
|
URL
|
url | string |
Specify the URL of the event |
|
|
Private
|
isprivate | boolean |
Specify if the event is private or not |
|
|
Is all day
|
isallday | boolean |
Specify if the event is an all day event. |
|
|
email ID
|
string |
Specify the attendees' email addresses |
||
|
Transparency
|
transparency | integer |
Specify if the event should be added to your free/busy schedule. |
|
|
Allow Forward
|
allowForwarding | boolean |
Specify if the event can be forwarded or not |
|
|
type
|
action | string |
Specify the event reminder type (email, notifications, etc.) |
|
|
in minutes
|
minutes | integer |
Specify time to remind you before or after the event (Eg: - 5 for before, 5 for after) |
Returns
- Body
- SingleEventRes
Delete event
Deletes an event from the user's calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
Event
|
euid | True | string |
Enter the event's unique id. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
events
|
events | array of object |
events |
|
uid
|
events.uid | string |
uid |
|
recurrenceid
|
events.recurrenceid | string |
recurrenceid |
Get calendar details
retrieves the details of a particular calendar using the Calendar UID.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
Returns
- Body
- SingleCalendarRes
Get calendar list
Gets the list of all calendars with the calendar UID, name, and timezone.
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
calendars
|
calendars | array of SingleCalendarRes |
calendars |
Get event
Gets the details of a particular event such as the event title, start date, end date, etc., from a user's specified calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
Event
|
euid | True | string |
Enter the event's unique id. |
Returns
- Body
- SingleEventRes
Get Event list
Gets the list of all the events between the specified date range in yyyy-MM-ddTHH:mm:sszzz format.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
By Instance
|
byinstance | True | boolean |
Retrieves all the instances of repeat events as a separate event when it is set as true. Date range shouldn't exceed 31 days. |
|
Start time
|
start | True | string |
Specify the start time in the format yyyy-MM-ddThh:mm:sszzz |
|
End time
|
end | True | string |
Specify the end time in the format yyyy-MM-ddThh:mm:sszzz |
|
Timezone
|
timezone | string |
Specify the event's timezone |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
events
|
events | array of SingleEventRes |
events |
Search Events
Gets the list of events across all calendars.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
Start time
|
start | True | string |
Specify event start time in the format yyyy-MM-ddTHH:mm:sszzz. |
|
End time
|
end | string |
Specify event end time in the format yyyy-MM-ddTHH:mm:sszzz. |
|
|
Search text
|
searchtext | string |
Specify should be searched for in title |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
search
|
search | array of object |
search |
|
Event unique ID
|
search.uid | string |
Unique identifier of the event |
|
Is all day event
|
search.isallday | boolean |
Whether the event is an all-day event |
|
Calendar unique ID
|
search.caluid | string |
Unique identifier of the calendar |
|
Title
|
search.title | string |
Title of the event |
|
type
|
search.type | integer |
type |
|
Timezone
|
search.dateandtime.timezone | string |
timezone of the event |
|
start time
|
search.dateandtime.start | string |
Start time of the event |
|
end time
|
search.dateandtime.end | string |
End time of the event |
Update Event
Updates an existing event in a user's calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar
|
cuid | True | string |
Specify calendar or enter the calendar's unique id. |
|
Event
|
euid | True | string |
Enter the event's unique id. |
|
Title
|
title | True | string |
Specify the event title |
|
Start time
|
start | True | string |
Specify the event start time in the format yyyy-MM-ddTHH:mm:sszzz |
|
End time
|
end | True | string |
Specify the event end time in the format yyyy-MM-ddTHH:mm:sszzz |
|
Timezone
|
timezone | string |
Specify the event's timezone |
|
|
Color
|
color | string |
Choose the event color or specify the color's hexdecimal value |
|
|
Description
|
description | string |
Specify the description of the event |
|
|
Location
|
location | string |
Specify the location of the event |
|
|
URL
|
url | string |
Specify the URL of the event |
|
|
Private
|
isprivate | boolean |
Specify if the event is private or not |
|
|
Is all day
|
isallday | boolean |
Specify if the event is an all day event. |
|
|
email ID
|
string |
Specify the attendees' email addresses |
||
|
Transparency
|
transparency | integer |
Specify if the event should be added to your free/busy schedule. |
|
|
Allow Forward
|
allowForwarding | boolean |
Specify if the event can be forwarded or not |
|
|
type
|
action | string |
Specify the event reminder type (email, notifications, etc.) |
|
|
in minutes
|
minutes | integer |
Specify time to remind you before or after the event (Eg: - 5 for before, 5 for after) |
Returns
- Body
- SingleEventRes
Triggers
| Delete event notification |
When an event is deleted in a calendar |
| Edit event notification |
When an event is updated to a calendar |
| New event notification |
When an event is added to a calendar |
Delete event notification
When an event is deleted in a calendar
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Event unique ID
|
zc_data.uid | string |
Unique identifier of the event |
|
Calendar unique ID
|
zc_data.caluid | string |
Unique identifier of the calendar |
Edit event notification
New event notification
Definitions
SingleEventRes
| Name | Path | Type | Description |
|---|---|---|---|
|
Color
|
color | string |
Event color value in hexadecimal |
|
Title
|
title | string |
Title of the event |
|
Duration
|
duration | string |
Duration of the event |
|
Event unique ID
|
uid | string |
Unique identifier of the event |
|
Event created by
|
createdby | string |
The user who created the event |
|
Is Approved
|
isApproved | boolean |
Whether the created event is approved. |
|
Location
|
location | string |
The location of the event |
|
URL
|
url | string |
The URL of the event |
|
Event View URL
|
viewEventURL | string |
The unique URL of the event. |
|
timezone
|
dateandtime.timezone | string |
Timezone of the event |
|
start time
|
dateandtime.start | string |
Start time of the event |
|
end time
|
dateandtime.end | string |
End time of the event |
|
Event last modified on
|
lastmodifiedtime | string |
The date and time the event was last modified on |
|
Is private
|
isprivate | boolean |
Whether the event is a private event or not |
|
Attendees
|
attendees | array of object |
Attendees of the event |
|
display name
|
attendees.dName | string |
Display names of attendees |
|
email ID
|
attendees.email | string |
The email addresses of the attendees. |
|
attendence
|
attendees.attendance | integer |
Whether the attendance is mandatory, optional, or not required. |
|
status
|
attendees.status | string |
Refers to the attendees status (Accepted/Declined/Tentative/Needs Action) |
|
Created on
|
createdtime_millis | string |
The event creation time in GMT |
|
Notification type
|
notifyType | integer |
Notifies attendees about the event based on their default notification preference. |
|
Organizer
|
organizer | string |
Details of the event organizer. |
|
Is all day event
|
isallday | boolean |
Whether the event is an all-day event |
|
Transparency
|
transparency | integer |
Whether the event should be added to free/busy schedule |
|
Modified by
|
modifiedby | string |
Refers to the user who modified the event. |
|
Event tag
|
etag | string |
Refers to the event tag to identify the mode in which the event was created/ modified. |
|
Calendar unique ID
|
caluid | string |
Unique identifier of the calendar |
|
Allow forwarding
|
allowForwarding | boolean |
Whether the event can be forwarded or not. |
|
reminders
|
reminders | array of object | |
|
Reminder type
|
reminders.action | string |
Refers to the event reminder type (mail, notification, popup.) |
|
Remind me in
|
reminders.minutes | string |
Refers to the reminder time in minutes. |
SingleCalendarRes
| Name | Path | Type | Description |
|---|---|---|---|
|
Color
|
color | string |
Calendar color value in hexadecimal |
|
Timezone
|
timezone | string |
Timezone of the calendar |
|
Text color
|
textcolor | string |
Calendar text color in hexadecimal |
|
Description
|
description | string |
the description of the calendar |
|
Calendar unique ID
|
uid | string |
Unique identifier of the calendar |
|
Is default
|
isdefault | boolean |
Whether the calendar is a default calendar |
|
Include free/busy
|
include_infreebusy | boolean |
Free/Busy status of the calendar |
|
Name
|
name | string |
name of the calendar |
|
Status
|
status | boolean |
Status of the calendar |
EventNotifyRes
| Name | Path | Type | Description |
|---|---|---|---|
|
Color
|
zc_data.color | string |
Event color value in hexadecimal |
|
Title
|
zc_data.title | string |
Title of the event |
|
Created on
|
zc_data.createdtime | string |
created time of event |
|
User timezone
|
zc_data.user_timezone | string |
Timezone of user |
|
Event duration
|
zc_data.duration | string |
Duration of the event |
|
Event unique ID
|
zc_data.uid | string |
Unique identifier of the event |
|
Is all day event
|
zc_data.isallday | boolean |
Whether the event is an all-day event |
|
Location
|
zc_data.location | string |
Location of the event |
|
etag
|
zc_data.etag | string |
Refers to the event tag to identify the mode in which the event was created/ modified. |
|
Calendar unique Id
|
zc_data.caluid | string |
Unique identifier of the calendar |
|
timezone
|
zc_data.dateandtime.timezone | string |
Timezone of the event |
|
start time
|
zc_data.dateandtime.start | string |
Start time of the event format yyyyMMddTHHmmss |
|
end time
|
zc_data.dateandtime.end | string |
End time of the event format yyyyMMddTHHmmss |
|
Event last modified on
|
zc_data.lastmodifiedtime | string |
The date and time the event was last modified on |