Googlecalendar

Learn how to use Googlecalendar with Composio

Overview

Enum

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

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
token
stringRequired

Actions

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

Action Parameters

calendar_id
stringRequired

Action Response

data
object
error
successful
boolean
Updates metadata for a calendar.

Action Parameters

calendarId
stringRequired
description
string
location
string
summary
stringRequired
timeZone
string

Action Response

data
object
error
successful
boolean
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
id
stringRequired
notification_settings
object
selected
boolean
summary_override
string

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
Creates a new, empty google calendar with the specified title (summary).

Action Parameters

summary
string

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
q
string
sharedExtendedProperty
string
showDeleted
boolean
showHiddenInvitations
boolean
singleEvents
boolean
syncToken
string
timeMax
string
timeMin
string
timeZone
string
updatedMin
string

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
Watch for changes to events resources.

Action Parameters

address
stringRequired
calendarId
stringRequired
id
stringRequired
params
object
payload
boolean
token
string
type
stringDefaults to web_hook

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
Gets the current date and time, allowing for a specific timezone offset.

Action Parameters

timezone
number

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
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
object
error
successful
boolean
Partially updates (patches) an existing google calendar, modifying only the fields provided; `summary` is mandatory and cannot be an empty string, and an empty string for `description` or `location` clears them.

Action Parameters

calendar_id
stringRequired
description
string
location
string
summary
stringRequired
timezone
string

Action Response

data
object
error
successful
boolean
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
object
error
successful
boolean
Parses natural language text to quickly create a basic google calendar event with its title, date, and time, suitable for simple scheduling; does not support recurring events or direct attendee addition via parameters, and `calendar id` must be valid if not 'primary'.

Action Parameters

calendar_id
stringDefaults to primary
send_updates
stringDefaults to none
text
string

Action Response

data
object
error
successful
boolean
Removes an attendee from a specified event in a google calendar; the calendar and event must exist.

Action Parameters

attendee_email
stringRequired
calendar_id
stringDefaults to primary
event_id
stringRequired

Action Response

data
object
error
successful
boolean
Returns all user settings for the authenticated user.

Action Parameters

maxResults
integer
pageToken
string
syncToken
string

Action Response

data
object
error
successful
boolean
Watch for changes to settings resources.

Action Parameters

address
stringRequired
id
stringRequired
params
object
token
string
type
stringRequired

Action Response

data
object
error
successful
boolean
Synchronizes google calendar events, performing a full sync if no `sync token` is provided or if a 410 gone error (due to an expired token) necessitates it, otherwise performs an incremental sync for events changed since the `sync token` was issued.

Action Parameters

calendar_id
stringDefaults to primary
event_types
array
max_results
integer
pageToken
string
single_events
boolean
sync_token
string

Action Response

data
object
error
successful
boolean
Updates an access control rule for the specified calendar.

Action Parameters

calendar_id
stringRequired
role
stringRequired
rule_id
stringRequired
send_notifications
booleanDefaults to True

Action Response

data
object
error
successful
boolean
Updates an existing event by `event id` in a google calendar; this is a full put replacement, so provide all desired fields as unspecified ones may be cleared or reset.

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
event_id
stringRequired
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
object
error
successful
boolean