Dela via


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
Email 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
email 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

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

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

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
email 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

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

When an event is updated to a calendar

Returns

New event notification

When an event is added to a calendar

Returns

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