Google Calendar
Google Calendar lets you organize your schedule and share events with co-workers and friends. With Google's free online calendar, it's easy to keep track of your daily schedule.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Standard | All Power Automate regions except the following: - China Cloud operated by 21Vianet |
| Power Apps | Standard | All Power Apps regions except the following: - China Cloud operated by 21Vianet |
| Contact | |
|---|---|
| Name | Microsoft |
| URL | Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support |
| Connector Metadata | |
|---|---|
| Publisher | Microsoft |
| Website | https://calendar.google.com/calendar |
| Privacy policy | https://policies.google.com/privacy |
To use this integration, you will need a Google account. If you are not a user yet, sign up for a new account. When trying to make a connection, you will be prompted to authenticate against your account. If you have multiple accounts, pick the one you would like to use and Sign in. Once verified, you will need to authorize Microsoft to access your contacts. Click on Allow to continue.
You're now ready to start using this integration.
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
| Frequency of trigger polls | 1 | 90 seconds |
Actions
| Create an event |
This operation is used to create an event on a specific calendar. |
| Delete an event |
This operation is used to delete an event from a calendar. |
| Get an event |
This operation is used to get the details of a specific event from a calendar. |
| List calendars |
This operation is used to list all calendars in your Google account. |
| List the events on a calendar |
This operation is used to return the first page of arbitrarily ordered events on the selected calendar. |
| Update an event |
This operation is used to update an existing event on a calendar. |
Create an event
This operation is used to create an event on a specific calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendarId | True | string |
Unique ID of the calendar to fetch events from. |
|
Title
|
summary | string |
A summary of the event. |
|
|
Start time
|
start | True | date-time |
The (inclusive) start time of the event. |
|
End time
|
end | True | date-time |
The (exclusive) end time of the event. |
|
Description
|
description | string |
Description of the event. |
|
|
Location
|
location | string |
Geographic location of the event as free-form text. |
|
|
Attendees
|
attendees | string |
Enter a comma-separated list of attendee emails. |
|
|
Status
|
status | string |
Status of the event. Possible values are "confirmed", "tentative", or "cancelled". |
|
|
Is all-day
|
isAllDay | boolean |
Is all-day event? |
Returns
Details of a single calendar event.
- Event
- ResponseEvent
Delete an event
This operation is used to delete an event from a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendarId | True | string |
Unique ID of the calendar to fetch events from. |
|
Event ID
|
eventId | True | string |
Unique ID of the event to update. |
Returns
- response
- object
Get an event
This operation is used to get the details of a specific event from a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendarId | True | string |
Unique ID of the calendar to fetch events from. |
|
Event ID
|
eventId | True | string |
Unique ID of the event to get. |
Returns
Details of a single calendar event.
- Event
- ResponseEvent
List calendars
This operation is used to list all calendars in your Google account.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Minimum Access Role
|
minAccessRole | string |
The minimum access role users must have to view calendars. |
Returns
List of one or multiple calendars.
- Calendar List
- CalendarList
List the events on a calendar
This operation is used to return the first page of arbitrarily ordered events on the selected calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendarId | True | string |
Unique ID of the calendar to fetch events from. |
|
Min Time
|
timeMin | date-time |
Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T08:00:00.000Z). |
|
|
Max time
|
timeMax | date-time |
Time format: yyyy-MM-ddTHH:mm:ss.fffZ (2016-07-20T09:00:59.000Z). |
|
|
Search query
|
q | string |
Text search terms to find events that match these terms in any fields |
Returns
List of events in a calendar.
- Event List
- CalendarEventList
Update an event
This operation is used to update an existing event on a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendarId | True | string |
Unique ID of the calendar to fetch events from. |
|
Event ID
|
eventId | True | string |
Unique ID of the event to get. |
|
Title
|
summary | string |
A summary of the event. |
|
|
Start time
|
start | date-time |
The (inclusive) start time of the event. |
|
|
End time
|
end | date-time |
The (exclusive) end time of the event. |
|
|
Description
|
description | string |
Description of the event. |
|
|
Location
|
location | string |
Geographic location of the event as free-form text. |
|
|
Attendees
|
attendees | string |
Enter a comma-separated list of attendee emails. |
|
|
Status
|
status | string |
Status of the event. Possible values are "confirmed", "tentative", or "cancelled. |
|
|
Is all-day
|
isAllDay | boolean |
Is all-day event? |
Returns
Details of a single calendar event.
- Event
- ResponseEvent
Triggers
| When an event is added, updated or deleted from a calendar |
This operation triggers when a new event is added, updated or deleted from a calendar. |
| When an event is added to a calendar |
This operation triggers when a new event is added to a calendar. |
| When an event is deleted from a calendar |
This operation triggers when a new event is deleted from a calendar. |
| When an event is updated in a calendar |
This operation triggers when an event is updated in a calendar. |
| When an event starts |
This operation triggers when an event starts. |
When an event is added, updated or deleted from a calendar
This operation triggers when a new event is added, updated or deleted from a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendar_id | True | string |
Unique ID of the calendar to fetch events from. |
|
Expand Recurring Events?
|
singleEvents | boolean |
Whether to expand recurring events into instances. |
Returns
List of events in a calendar.
- Changed Event List
- CalendarEventChangedList
When an event is added to a calendar
This operation triggers when a new event is added to a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendar_id | True | string |
Unique ID of the calendar to fetch events from. |
Returns
List of events in a calendar.
- Event List
- CalendarEventList
When an event is deleted from a calendar
This operation triggers when a new event is deleted from a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendar_id | True | string |
Unique ID of the calendar to fetch events from. |
Returns
List of events in a calendar.
- Event List
- CalendarEventList
When an event is updated in a calendar
This operation triggers when an event is updated in a calendar.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendar_id | True | string |
Unique ID of the calendar to fetch events from. |
Returns
List of events in a calendar.
- Event List
- CalendarEventList
When an event starts
This operation triggers when an event starts.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Calendar ID
|
calendar_id | True | string |
Unique ID of the calendar to fetch events from. |
Returns
List of events in a calendar.
- Event List
- CalendarEventList
Definitions
CalendarList
List of one or multiple calendars.
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
items | array of CalendarListEntry |
Calendars in the list. |
CalendarListEntry
Details about a single Google calendar.
| Name | Path | Type | Description |
|---|---|---|---|
|
Calendar ID
|
id | string |
Identifier of the calendar. |
|
Summary
|
summary | string |
Title of the calendar. |
|
Description
|
description | string |
Description of the calendar. |
|
Location
|
location | string |
Geographic location of the calendar as free-form text. |
|
Time Zone
|
timeZone | string |
The time zone of the calendar. |
CalendarEventList
List of events in a calendar.
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
items | array of ResponseEvent |
Events in the calendar. |
CalendarEventChangedList
List of events in a calendar.
| Name | Path | Type | Description |
|---|---|---|---|
|
Items
|
items | array of ResponseEventWithActionType |
Changed events in the calendar. |
ResponseEvent
Details of a single calendar event.
| Name | Path | Type | Description |
|---|---|---|---|
|
Title
|
summary | string |
A summary of the event. |
|
Start Date-Time
|
start | date-time |
The (inclusive) start time of the event. |
|
End Date-time
|
end | date-time |
The (exclusive) end time of the event. |
|
Description
|
description | string |
Description of the event. |
|
Location
|
location | string |
Geographic location of the event as free-form text. |
|
Status
|
status | string |
Status of the event. Possible values are "confirmed", "tentative", or "cancelled". |
|
HTML link
|
htmlLink | string |
Unique ID of the list. |
|
Event ID
|
id | string |
Opaque identifier of the event. |
|
Attendees
|
attendees | string |
The event's attendees. |
|
Creator
|
creator | string |
The creator of the event. |
|
Organizer
|
organizer | string |
The organizer of the event. |
ResponseEventWithActionType
Details of a single calendar event and what action changes the event.
| Name | Path | Type | Description |
|---|---|---|---|
|
Action Type
|
actionType | string |
Type of action which changed the event in change trigger. |
|
Title
|
summary | string |
A summary of the event. |
|
Start Date-Time
|
start | date-time |
The (inclusive) start time of the event. |
|
End Date-time
|
end | date-time |
The (exclusive) end time of the event. |
|
Description
|
description | string |
Description of the event. |
|
Location
|
location | string |
Geographic location of the event as free-form text. |
|
Status
|
status | string |
Status of the event. Possible values are "confirmed", "tentative", or "cancelled". |
|
HTML link
|
htmlLink | string |
Unique ID of the list. |
|
Event ID
|
id | string |
Opaque identifier of the event. |
|
Attendees
|
attendees | string |
The event's attendees. |
|
Creator
|
creator | string |
The creator of the event. |
|
Organizer
|
organizer | string |
The organizer of the event. |
object
This is the type 'object'.