Googlecalendar | Composio Docs

Overview

SLUG

GOOGLECALENDAR

Description

Google Calendar is a time management tool providing scheduling features, event reminders, and integration with email and other apps for streamlined organization

Authentication Details

OAuth2

client_id

stringRequired

client_secret

stringRequired

oauth_redirect_uri

stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add

scopes

stringDefaults to https://www.googleapis.com/auth/calendar,https://www.googleapis.com/auth/calendar.events

bearer_token

string

Bearer Token

token

stringRequired

Tools

Patch Event

SLUG: GOOGLECALENDAR_PATCH_EVENT

Updates specified fields of an existing event in a google calendar using patch semantics (array fields like `attendees` are fully replaced if provided); ensure the `calendar id` and `event id` are valid and the user has write access to the calendar.

Action Parameters

attendees

array

calendar_id

stringRequired

conference_data_version

integer

description

string

end_time

string

event_id

stringRequired

location

string

max_attendees

integer

send_updates

string

start_time

string

summary

string

supports_attachments

boolean

timezone

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete Calendar

SLUG: GOOGLECALENDAR_CALENDARS_DELETE

Deletes a secondary calendar. use calendars.clear for clearing all events on primary calendars.

Action Parameters

calendar_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update Calendar

SLUG: GOOGLECALENDAR_CALENDARS_UPDATE

Updates metadata for a calendar.

Action Parameters

calendarId

stringRequired

description

string

location

string

summary

stringRequired

timeZone

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Insert Calendar into List

SLUG: GOOGLECALENDAR_CALENDAR_LIST_INSERT

Inserts an existing calendar into the user's calendar list.

Action Parameters

background_color

string

color_id

string

color_rgb_format

boolean

default_reminders

array

foreground_color

string

hidden

boolean

stringRequired

notification_settings

object

selected

boolean

summary_override

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Update Calendar List Entry

SLUG: GOOGLECALENDAR_CALENDAR_LIST_UPDATE

Updates an existing entry on the user\'s calendar list.

Action Parameters

backgroundColor

string

calendar_id

stringRequired

colorId

string

colorRgbFormat

boolean

defaultReminders

array

foregroundColor

string

hidden

boolean

notificationSettings

object

selected

boolean

summaryOverride

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Clear Calendar

SLUG: GOOGLECALENDAR_CLEAR_CALENDAR

Clears a primary calendar. this operation deletes all events associated with the primary calendar of an account.

Action Parameters

calendar_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create Event

SLUG: GOOGLECALENDAR_CREATE_EVENT

Creates an event on a google calendar, needing rfc3339 utc start/end times (end after start) and write access to the calendar.

Action Parameters

attendees

array

calendar_id

stringDefaults to primary

create_meeting_room

boolean

description

string

eventType

stringDefaults to default

event_duration_hour

integer

event_duration_minutes

integerDefaults to 30

guestsCanInviteOthers

boolean

guestsCanSeeOtherGuests

boolean

guests_can_modify

boolean

location

string

recurrence

array

send_updates

boolean

start_datetime

stringRequired

summary

string

timezone

string

transparency

stringDefaults to opaque

visibility

stringDefaults to default

Action Response

data

objectRequired

error

string

successful

booleanRequired

Delete event

SLUG: GOOGLECALENDAR_DELETE_EVENT

Deletes a specified event by `event id` from a google calendar (`calendar id`); this action is idempotent and raises a 404 error if the event is not found.

Action Parameters

calendar_id

stringDefaults to primary

event_id

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

Create a calendar

SLUG: GOOGLECALENDAR_DUPLICATE_CALENDAR

Creates a new, empty google calendar with the specified title (summary).

Action Parameters

summary

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get Event Instances

SLUG: GOOGLECALENDAR_EVENTS_INSTANCES

Returns instances of the specified recurring event.

Action Parameters

calendarId

stringRequired

eventId

stringRequired

maxAttendees

integer

maxResults

integer

originalStart

string

pageToken

string

showDeleted

boolean

timeMax

string

timeMin

string

timeZone

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

List Events

SLUG: GOOGLECALENDAR_EVENTS_LIST

Returns events on the specified calendar.

Action Parameters

alwaysIncludeEmail

boolean

calendarId

stringRequired

eventTypes

string

iCalUID

string

maxAttendees

integer

maxResults

integer

orderBy

string

pageToken

string

privateExtendedProperty

string

sharedExtendedProperty

string

showDeleted

boolean

showHiddenInvitations

boolean

singleEvents

boolean

syncToken

string

timeMax

string

timeMin

string

timeZone

string

updatedMin

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Move Event

SLUG: GOOGLECALENDAR_EVENTS_MOVE

Moves an event to another calendar, i.e., changes an event's organizer.

Action Parameters

calendar_id

stringRequired

destination

stringRequired

event_id

stringRequired

send_updates

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Watch Events

SLUG: GOOGLECALENDAR_EVENTS_WATCH

Watch for changes to events resources.

Action Parameters

address

stringRequired

calendarId

stringRequired

params

object

payload

boolean

token

string

type

stringDefaults to web_hook

Action Response

data

objectRequired

error

string

successful

booleanRequired

Find event

SLUG: GOOGLECALENDAR_FIND_EVENT

Finds events in a specified google calendar using text query, time ranges (event start/end, last modification), and event types; ensure `timemin` is not chronologically after `timemax` if both are provided.

Action Parameters

calendar_id

stringDefaults to primary

event_types

arrayDefaults to ['default', 'outOfOffice', 'focusTime', 'workingLocation']

max_results

integerDefaults to 10

order_by

string

page_token

string

query

string

show_deleted

boolean

single_events

booleanDefaults to True

timeMax

string

timeMin

string

updated_min

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Find free slots

SLUG: GOOGLECALENDAR_FIND_FREE_SLOTS

Finds free/busy time slots in google calendars for specified calendars within a defined time range (defaults to the current day utc if `time min`/`time max` are omitted), enhancing busy intervals with event details; `time min` must precede `time max` if both are provided.

Action Parameters

calendar_expansion_max

integerDefaults to 50

group_expansion_max

integerDefaults to 100

items

arrayDefaults to ['primary']

time_max

string

time_min

string

timezone

stringDefaults to UTC

Action Response

data

objectRequired

error

string

successful

booleanRequired

Query Free/Busy Information

SLUG: GOOGLECALENDAR_FREE_BUSY_QUERY

Returns free/busy information for a set of calendars.

Action Parameters

calendarExpansionMax

integer

groupExpansionMax

integer

items

arrayRequired

timeMax

stringRequired

timeMin

stringRequired

timeZone

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get Google Calendar

SLUG: GOOGLECALENDAR_GET_CALENDAR

Retrieves a specific google calendar, identified by `calendar id`, to which the authenticated user has access.

Action Parameters

calendar_id

stringDefaults to primary

Action Response

data

objectRequired

error

string

successful

booleanRequired

Get current date and time

SLUG: GOOGLECALENDAR_GET_CURRENT_DATE_TIME

Gets the current date and time, allowing for a specific timezone offset.

Action Parameters

timezone

number

Action Response

data

objectRequired

error

string

successful

booleanRequired

List ACL Rules

SLUG: GOOGLECALENDAR_LIST_ACL_RULES

Retrieves the list of access control rules (acls) for a specified calendar, providing the necessary 'rule id' values required for updating specific acl rules.

Action Parameters

calendar_id

stringRequired

max_results

integer

page_token

string

show_deleted

boolean

sync_token

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

List Google Calendars

SLUG: GOOGLECALENDAR_LIST_CALENDARS

Retrieves calendars from the user's google calendar list, with options for pagination and filtering.

Action Parameters

max_results

integerDefaults to 10

min_access_role

string

page_token

string

show_deleted

boolean

show_hidden

boolean

sync_token

string

Action Response

data

objectRequired

error

string

successful

booleanRequired