Sign InGet Started
Sign InGet Started

Google Calendar Integration

Google Calendar API Operations

Browse all 37 operations available for Google Calendar workflow automation.

Back to Google Calendar

Acl

7 operations
POST/calendars/{calendarId}/acl

Create a calendar access control rule

Adds a new access control rule to a calendar, granting a user or group a specific permission level. Use this to share a calendar with someone or change their access from reader to writer.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.acls
1 path, 1 query params
DELETE/calendars/{calendarId}/acl/{ruleId}

Delete a calendar access control rule

Removes an access control rule from a calendar, revoking the specified user's or group's access. Use this to unshare a calendar or remove someone's permissions.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.acls
2 path params
GET/calendars/{calendarId}/acl/{ruleId}

Get a calendar access control rule

Retrieves a specific access control rule by its ID, showing the scope and permission level. Use this to check what access a particular user or group has to a calendar.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.aclshttps://www.googleapis.com/auth/calendar.acls.readonlyhttps://www.googleapis.com/auth/calendar.readonly
2 path params
GET/calendars/{calendarId}/acl

List calendar access control rules

Returns all access control rules for a calendar, showing who has access and their permission level. Use this to audit sharing permissions or check who can view or edit a calendar.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.aclshttps://www.googleapis.com/auth/calendar.acls.readonly
1 path, 4 query params
PATCH/calendars/{calendarId}/acl/{ruleId}

Partially update a calendar access control rule

Updates specific fields of an access control rule without replacing the entire resource. Use this when you only need to change the permission role without modifying the scope.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.acls
2 path, 1 query params
PUT/calendars/{calendarId}/acl/{ruleId}

Update a calendar access control rule

Replaces an existing access control rule with new values. Use this to change a user's permission level on a calendar, such as upgrading them from reader to writer.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.acls
2 path, 1 query params
POST/calendars/{calendarId}/acl/watch

Watch for access control changes

Fires when calendar sharing permissions change

https://www.googleapis.com/auth/calendar.acls.readonlyhttps://www.googleapis.com/auth/calendar.acls
1 path, 4 query params

Calendarlist

7 operations
POST/users/me/calendarList

Add a calendar to the user's calendar list

Subscribes the user to an existing calendar by adding it to their calendar list. Use this to give a user visibility into a shared or public calendar without creating a new one.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.calendarlist
1 query params
GET/users/me/calendarList/{calendarId}

Get a calendar from the user's calendar list

Retrieves a specific calendar entry from the user's calendar list, including display preferences like color and notification settings. Use this to check how a particular calendar is configured for the user.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlisthttps://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.readonly
1 path params
GET/users/me/calendarList

List calendars in the user's calendar list

List the user's subscribed calendars

https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.readonly
6 query params
PATCH/users/me/calendarList/{calendarId}

Partially update a calendar list entry

Updates specific display preferences for a calendar in the user's list without replacing all settings. Use this to change just the color or notification preferences for a subscribed calendar.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlist
1 path, 1 query params
DELETE/users/me/calendarList/{calendarId}

Remove a calendar from the user's calendar list

Unsubscribes the user from a calendar by removing it from their calendar list. The calendar itself is not deleted, only the user's subscription to it.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlist
1 path params
PUT/users/me/calendarList/{calendarId}

Update a calendar list entry

Replaces the user's display preferences for a calendar in their list, including color, notification settings, and visibility. This performs a full replacement of the calendar list entry.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlist
1 path, 1 query params
POST/users/me/calendarList/watch

Watch for calendar list changes

Fires when the user's calendar list changes (calendar added or removed)

https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.readonly
6 query params

Calendars

6 operations
POST/calendars/{calendarId}/clear

Clear all events from a primary calendar

Deletes all events from a primary calendar without deleting the calendar itself. Use this for a fresh start on a user's main calendar. For secondary calendars, use the delete operation instead.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.calendars
1 path params
POST/calendars

Create a secondary calendar

Creates a new secondary calendar owned by the authenticated user. Use this to set up project-specific or team calendars. The authenticated user becomes the data owner, so avoid using service accounts for authentication.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendars
DELETE/calendars/{calendarId}

Delete a secondary calendar

Permanently deletes a secondary calendar and all its events. This cannot be undone. To clear events from a primary calendar without deleting it, use the clear operation instead.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendars
1 path params
GET/calendars/{calendarId}

Get calendar metadata

Retrieves metadata for a specific calendar by its ID. Use this to look up a calendar's title, description, time zone, and other properties.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarshttps://www.googleapis.com/auth/calendar.calendars.readonlyhttps://www.googleapis.com/auth/calendar.readonly
1 path params
PATCH/calendars/{calendarId}

Partially update calendar metadata

Updates specific fields of a calendar's metadata without replacing the entire resource. Use this instead of a full update when you only need to change one or two properties like the title or time zone.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendars
1 path params
PUT/calendars/{calendarId}

Update calendar metadata

Replaces the metadata for a calendar, including its title, description, and time zone. This performs a full replacement, so include all fields you want to keep.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendars
1 path params

Channels

1 operation
POST/channels/stop

Stop a push notification channel

Stops receiving push notifications for a previously created watch channel. Use this to clean up notification subscriptions when you no longer need real-time updates for a calendar or resource.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.aclshttps://www.googleapis.com/auth/calendar.acls.readonlyhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlisthttps://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.ownedhttps://www.googleapis.com/auth/calendar.events.owned.readonlyhttps://www.googleapis.com/auth/calendar.events.public.readonlyhttps://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/calendar.settings.readonly

Colors

1 operation
GET/colors

Get color definitions

Returns the set of color definitions available for calendars and events. Use this to display color options in a UI or to map color IDs to their actual foreground and background values.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.calendarlisthttps://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.ownedhttps://www.googleapis.com/auth/calendar.events.owned.readonlyhttps://www.googleapis.com/auth/calendar.events.public.readonlyhttps://www.googleapis.com/auth/calendar.readonly

Events

11 operations
POST/calendars/{calendarId}/events

Create a calendar event

Create a new calendar event

https://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.owned
1 path, 5 query params
DELETE/calendars/{calendarId}/events/{eventId}

Delete a calendar event

Delete a calendar event

https://www.googleapis.com/auth/calendar.events
2 path, 2 query params
GET/calendars/{calendarId}/events/{eventId}

Get a calendar event

Get details of a specific event

https://www.googleapis.com/auth/calendar.events.readonly
2 path, 3 query params
POST/calendars/{calendarId}/events/import

Import an event to a calendar

Adds a private copy of an existing event to a calendar using its iCalendar ID. Use this to import events from external calendar systems or create local copies of events from other calendars. Only default event types can be imported.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.owned
1 path, 2 query params
GET/calendars/{calendarId}/events

List events on a calendar

List events on a calendar

https://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.readonly
1 path, 18 query params
GET/calendars/{calendarId}/events/{eventId}/instances

List instances of a recurring event

Returns individual occurrences of a recurring event, each with its own date, time, and any per-instance overrides. Use this to see the expanded schedule for a repeating event or to find a specific occurrence to modify.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.ownedhttps://www.googleapis.com/auth/calendar.events.owned.readonlyhttps://www.googleapis.com/auth/calendar.events.public.readonlyhttps://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.readonly
2 path, 9 query params
POST/calendars/{calendarId}/events/{eventId}/move

Move an event to another calendar

Transfers an event from one calendar to another, changing the event's organizer. Use this to reassign ownership of an event or move it between project calendars. Only default events can be moved; birthday, focus time, and out-of-office events cannot.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.owned
2 path, 3 query params
PATCH/calendars/{calendarId}/events/{eventId}

Partially update a calendar event

Update an existing calendar event

https://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.owned
2 path, 6 query params
POST/calendars/{calendarId}/events/quickAdd

Quick-add an event from text

Create an event from a text string

https://www.googleapis.com/auth/calendar.events
1 path, 3 query params
PUT/calendars/{calendarId}/events/{eventId}

Update a calendar event

Replaces an existing event with updated values. This performs a full replacement, so include all fields you want to keep. Use this to reschedule events, update attendee lists, or modify event details.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.app.createdhttps://www.googleapis.com/auth/calendar.eventshttps://www.googleapis.com/auth/calendar.events.owned
2 path, 6 query params
POST/calendars/{calendarId}/events/watch

Watch for event changes

Fires when events on a calendar are created, updated, or deleted

https://www.googleapis.com/auth/calendar.events.readonlyhttps://www.googleapis.com/auth/calendar.readonly
1 path, 18 query params

Freebusy

1 operation
POST/freeBusy

Query free/busy availability

Check free/busy availability

https://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.freebusy

Settings

3 operations
GET/users/me/settings/{setting}

Get a single user setting

Retrieves a specific calendar setting by its key, such as the user's time zone or preferred date format. Use this to look up an individual preference without fetching all settings.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/calendar.settings.readonly
1 path params
GET/users/me/settings

List all user settings

Returns all calendar settings for the authenticated user, such as time zone, date format, default event duration, and notification preferences. Use this to understand or replicate a user's calendar configuration.

https://www.googleapis.com/auth/calendarhttps://www.googleapis.com/auth/calendar.readonlyhttps://www.googleapis.com/auth/calendar.settings.readonly
3 query params
POST/users/me/settings/watch

Watch for settings changes

Fires when user calendar settings change

https://www.googleapis.com/auth/calendar.settings.readonly
3 query params