NAiOS IconNAiOS Logo
Contacto
Volver al catálogo

Google Calendar

googlecalendar

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

Scheduling & BookingWeb del proveedor
Acciones
28
Triggers
7
Autenticación
—
OAuth gestionado
Sí
Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (28)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Insert Calendar into ListGOOGLECALENDAR_CALENDAR_LIST_INSERTAcción

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

Parámetros de entrada

  • idstringObligatorio

    The identifier of the calendar to insert.

  • hiddenboolean

    Whether the calendar has been hidden from the list. Default is False.

  • color_idstring

    The color of the calendar. This is an ID referring to an entry in the calendarCore color palette.

  • selectedboolean

    Whether the calendar is selected and visible in the calendar list. Default is True.

  • background_colorstring

    The background color of the calendar in the Web UI. (Hexadecimal color code)

  • color_rgb_formatboolean

    Whether to use the foregroundColor and backgroundColor fields to write the calendar colors (RGB). If this feature is used, the index-based colorId field will be set to the best matching option automatically. Optional. The default is False.

  • foreground_colorstring

    The foreground color of the calendar in the Web UI. (Hexadecimal color code)

  • summary_overridestring

    The summary that the authenticated user has set for this calendar.

  • default_remindersobject[]

    The default reminders that the authenticated user has for this calendar.

  • notification_settingsobject

    The notifications that the authenticated user is receiving for this calendar.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Calendar List EntryGOOGLECALENDAR_CALENDAR_LIST_UPDATEAcción

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

Parámetros de entrada

  • hiddenboolean

    Whether calendar is hidden.

  • colorIdstring

    ID for calendar color from colors endpoint.

  • selectedboolean

    Whether calendar content shows in UI.

  • calendar_idstringObligatorio

    Calendar identifier. Use "primary" for the primary calendar.

  • colorRgbFormatboolean

    Whether to use RGB for foreground/background colors.

  • backgroundColorstring

    Hex color for calendar background.

  • foregroundColorstring

    Hex color for calendar foreground.

  • summaryOverridestring

    User-set summary for the calendar.

  • defaultRemindersobject[]

    List of default reminders.

  • notificationSettingsobject

    Notification settings for the calendar.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete CalendarGOOGLECALENDAR_CALENDARS_DELETEAcción

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

Parámetros de entrada

  • calendar_idstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update CalendarGOOGLECALENDAR_CALENDARS_UPDATEAcción

Updates metadata for a calendar.

Parámetros de entrada

  • summarystringObligatorio

    Title of the calendar.

  • locationstring

    Geographic location of the calendar as free-form text. Optional.

  • timeZonestring

    The time zone of the calendar. (Formatted as an IANA Time Zone Database name, e.g. "Europe/Zurich".) Optional.

  • calendarIdstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • descriptionstring

    Description of the calendar. Optional.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Clear CalendarGOOGLECALENDAR_CLEAR_CALENDARAcción

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

Parámetros de entrada

  • calendar_idstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the `calendarList.list` method. If you want to access the primary calendar of the currently logged in user, use the "`primary`" keyword.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create EventGOOGLECALENDAR_CREATE_EVENTAcción

Creates an event on a google calendar, needing rfc3339 utc start/end times (end after start) and write access to the calendar. by default, adds the organizer as an attendee unless exclude organizer is set to true.

Parámetros de entrada

  • summarystring

    Summary (title) of the event.

  • locationstring

    Geographic location of the event as free-form text.

  • timezonestring

    IANA timezone name (e.g., 'America/New_York'). Required if datetime is naive. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC.

  • attendeesstring[]

    List of attendee emails (strings).

  • eventTypestringenum

    Type of the event, immutable post-creation. Supported types: 'birthday' (all-day with annual recurrence), 'default' (regular event), 'focusTime' (focus-time event), 'outOfOffice' (out-of-office event), 'workingLocation' (working location event). Note: 'fromGmail' events cannot be created via API.

    birthdaydefaultfocusTimeoutOfOfficeworkingLocation
  • recurrencestring[]

    List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies are DAILY, WEEKLY, MONTHLY, YEARLY.

  • visibilitystringenum

    Event visibility: 'default', 'public', 'private', or 'confidential'.

    defaultpublicprivateconfidential
  • calendar_idstring

    Target calendar: 'primary' for the user's main calendar, or the calendar's email address.

  • descriptionstring

    Description of the event. Can contain HTML. Optional.

  • send_updatesboolean

    Defaults to True. Whether to send updates to the attendees.

  • transparencystringenum

    'opaque' (busy) or 'transparent' (available).

    opaquetransparent
  • start_datetimestringObligatorio

    Naive date/time (YYYY-MM-DDTHH:MM:SS) with NO offsets or Z. e.g. '2025-01-16T13:00:00'

  • exclude_organizerboolean

    If True, the organizer will NOT be added as an attendee. Default is False (organizer is included).

  • guests_can_modifyboolean

    If True, guests can modify the event.

  • create_meeting_roomboolean

    If true, a Google Meet link is created and added to the event. CRITICAL: As of 2024, this REQUIRES a paid Google Workspace account ($13+/month). Personal Gmail accounts will fail with 'Invalid conference type value' error. Solutions: 1) Upgrade to Workspace, 2) Use domain-wide delegation with Workspace user, 3) Use the new Google Meet REST API, or 4) Create events without conferences. See https://github.com/googleapis/google-api-nodejs-client/issues/3234

  • event_duration_hourinteger

    Number of hours (0-24). Increase by 1 here rather than passing 60 in `event_duration_minutes`

  • guestsCanInviteOthersboolean

    Whether attendees other than the organizer can invite others to the event.

  • event_duration_minutesinteger

    Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59.

  • guestsCanSeeOtherGuestsboolean

    Whether attendees other than the organizer can see who the event's attendees are.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Delete eventGOOGLECALENDAR_DELETE_EVENTAcción

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.

Parámetros de entrada

  • event_idstringObligatorio

    Unique identifier of the event to delete, typically obtained upon event creation.

  • calendar_idstring

    Identifier of the Google Calendar (e.g., email address, specific ID, or 'primary' for the authenticated user's main calendar) from which the event will be deleted.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Create a calendarGOOGLECALENDAR_DUPLICATE_CALENDARAcción

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

Parámetros de entrada

  • summarystring

    Title for the new Google Calendar to be created. If an empty string is provided, the calendar will be created without a title.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Event InstancesGOOGLECALENDAR_EVENTS_INSTANCESAcción

Returns instances of the specified recurring event.

Parámetros de entrada

  • eventIdstringObligatorio

    Recurring event identifier.

  • timeMaxstring

    Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset.

  • timeMinstring

    Lower bound (inclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset.

  • timeZonestring

    Time zone used in the response. Optional. The default is the time zone of the calendar.

  • pageTokenstring

    Token specifying which result page to return. Optional.

  • calendarIdstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the `calendarList.list` method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • maxResultsinteger

    Maximum number of events returned on one result page. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.

  • showDeletedboolean

    Whether to include deleted events (with status equals "cancelled") in the result. Cancelled instances of recurring events will still be included if `singleEvents` is False. Optional. The default is False.

  • maxAttendeesinteger

    The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.

  • originalStartstring

    The original start time of the instance in the result. Optional.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List EventsGOOGLECALENDAR_EVENTS_LISTAcción

Returns events on the specified calendar.

Parámetros de entrada

  • qstring

    Free text search terms to find events that match these terms in various fields. Optional.

  • iCalUIDstring

    Specifies an event ID in the iCalendar format to be provided in the response. Optional. Use this if you want to search for an event by its iCalendar ID.

  • orderBystring

    The order of the events returned in the result. Optional. The default is an unspecified, stable order. Acceptable values are: "startTime", "updated".

  • timeMaxstring

    Upper bound (exclusive) for an event's start time to filter by. Optional. The default is not to filter by start time. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. If timeMin is set, timeMax must be greater than timeMin.

  • timeMinstring

    Lower bound (exclusive) for an event's end time to filter by. Optional. The default is not to filter by end time. Must be an RFC3339 timestamp with mandatory time zone offset, for example, 2011-06-03T10:00:00-07:00, 2011-06-03T10:00:00Z. Milliseconds may be provided but are ignored. If timeMax is set, timeMin must be smaller than timeMax.

  • timeZonestring

    Time zone used in the response. Optional. The default is the user's primary time zone.

  • pageTokenstring

    Token specifying which result page to return. Optional.

  • syncTokenstring

    Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. Optional. The default is to return all entries.

  • calendarIdstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • eventTypesstring

    Event types to return. Optional. This parameter can be repeated multiple times to return events of different types. If unset, returns all event types. Acceptable values are: "birthday", "default", "focusTime", "fromGmail", "outOfOffice", "workingLocation".

  • maxResultsinteger

    Maximum number of events returned on one result page. The number of events in the resulting page may be less than this value, or none at all, even if there are more events matching the query. Incomplete pages can be detected by a non-empty nextPageToken field in the response. By default the value is 250 events. The page size can never be larger than 2500 events. Optional.

  • updatedMinstring

    Lower bound for an event's last modification time (as a RFC3339 timestamp) to filter by. When specified, entries deleted since this time will always be included regardless of showDeleted. Optional. The default is not to filter by last modification time.

  • showDeletedboolean

    Whether to include deleted events (with status equals "cancelled") in the result. Optional. The default is False.

  • maxAttendeesinteger

    The maximum number of attendees to include in the response. If there are more than the specified number of attendees, only the participant is returned. Optional.

  • singleEventsboolean

    Whether to expand recurring events into instances and only return single one-off events and instances of recurring events. Optional. The default is False.

  • alwaysIncludeEmailboolean

    Deprecated and ignored.

  • showHiddenInvitationsboolean

    Whether to include hidden invitations in the result. Optional. The default is False.

  • sharedExtendedPropertystring

    Extended properties constraint specified as propertyName=value. Matches only shared properties. This parameter might be repeated multiple times to return events that match all given constraints.

  • privateExtendedPropertystring

    Extended properties constraint specified as propertyName=value. Matches only private properties. This parameter might be repeated multiple times to return events that match all given constraints.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Move EventGOOGLECALENDAR_EVENTS_MOVEAcción

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

Parámetros de entrada

  • event_idstringObligatorio

    Event identifier. To retrieve event identifiers call the events.list method.

  • calendar_idstringObligatorio

    Calendar identifier of the source calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • destinationstringObligatorio

    Calendar identifier of the destination calendar. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • send_updatesstring

    Guests who should receive notifications about the change of the event's organizer. Acceptable values are: "all": Notifications are sent to all guests. "externalOnly": Notifications are sent to non-Google Calendar guests only. "none": No notifications are sent. This is the default value if left unspecified.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Watch EventsGOOGLECALENDAR_EVENTS_WATCHAcción

Watch for changes to events resources.

Parámetros de entrada

  • idstringObligatorio

    A UUID or similar unique string that identifies this channel.

  • typestring

    The type of delivery mechanism used for this channel.

  • tokenstring

    An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.

  • paramsobject

    Additional parameters controlling delivery channel behavior. Optional.

  • addressstringObligatorio

    The address where notifications are delivered for this channel.

  • payloadboolean

    A Boolean value to indicate whether payload is wanted. Optional.

  • calendarIdstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Find eventGOOGLECALENDAR_FIND_EVENTAcción

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.

Parámetros de entrada

  • querystring

    Free-text search terms to find events. This query is matched against various event fields including summary, description, location, attendees' details (displayName, email), and organizer's details.

  • timeMaxstring

    Upper bound (exclusive) for an event's start time to filter by. Only events starting before this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00')

  • timeMinstring

    Lower bound (exclusive) for an event's end time to filter by. Only events ending after this time are included. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00')

  • order_bystring

    Order of events: 'startTime' (ascending by start time) or 'updated' (ascending by last modification time).

  • page_tokenstring

    Token from a previous response's `nextPageToken` to fetch the subsequent page of results.

  • calendar_idstring

    Identifier of the Google Calendar to query. Use 'primary' for the primary calendar of the authenticated user, an email address for a specific user's calendar, or a calendar ID for other calendars.

  • event_typesstring[]

    Event types to include: 'default' (regular event), 'focusTime' (focused work time), 'outOfOffice' (out-of-office time).

  • max_resultsinteger

    Maximum number of events per page (1-2500).

  • updated_minstring

    Lower bound (exclusive) for an event's last modification time to filter by. Only events updated after this time are included. When specified, events deleted since this time are also included, regardless of the `show_deleted` parameter. Accepts multiple formats: 1. RFC3339 timestamp (e.g., '2024-12-06T13:00:00Z') 2. Comma-separated date/time parts (e.g., '2024,12,06,13,00,00') 3. Simple datetime string (e.g., '2024-12-06 13:00:00')

  • show_deletedboolean

    Include deleted events (status 'cancelled') in the result.

  • single_eventsboolean

    Expand recurring events into individual instances. If false, returns master recurring events.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Find free slotsGOOGLECALENDAR_FIND_FREE_SLOTSAcción

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.

Parámetros de entrada

  • itemsstring[]

    List of calendar identifiers (primary ID 'primary', user/calendar email, or unique calendar ID) to query for free/busy information.

  • time_maxstring

    End datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats.

  • time_minstring

    Start datetime for the query interval. Accepts ISO, comma-separated, or simple datetime formats.

  • timezonestring

    IANA timezone identifier (e.g., 'America/New_York', 'Europe/London') for interpreting `time_min` and `time_max` if they lack timezone info, and for expanding recurring events.

  • group_expansion_maxinteger

    Maximum calendar identifiers to return for a single group; exceeding this causes an error. Max allowed: 100.

  • calendar_expansion_maxinteger

    Maximum calendars for which FreeBusy information is provided. Max allowed: 50.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Query Free/Busy InformationGOOGLECALENDAR_FREE_BUSY_QUERYAcción

Returns free/busy information for a set of calendars.

Parámetros de entrada

  • itemsobject[]Obligatorio

    List of calendars and/or groups to query.

  • timeMaxstringObligatoriodate-time

    The end of the interval for the query formatted as per RFC3339.

  • timeMinstringObligatoriodate-time

    The start of the interval for the query formatted as per RFC3339.

  • timeZonestring

    Time zone used in the response. Optional. The default is UTC.

  • groupExpansionMaxinteger

    Maximal number of calendar identifiers to be provided for a single group. Optional. An error is returned for a group with more members than this value. Maximum value is 100.

  • calendarExpansionMaxinteger

    Maximal number of calendars for which FreeBusy information is to be provided. Optional. Maximum value is 50.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get Google CalendarGOOGLECALENDAR_GET_CALENDARAcción

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

Parámetros de entrada

  • calendar_idstring

    Identifier of the Google Calendar to retrieve. 'primary' (the default) represents the user's main calendar; other valid identifiers include the calendar's email address.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Get current date and timeGOOGLECALENDAR_GET_CURRENT_DATE_TIMEAcción

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

Parámetros de entrada

  • timezonenumber

    Timezone offset from UTC in hours (e.g., 6 for UTC+6, -9 for UTC-9, 5.5 for UTC+5:30). Default 0 is UTC.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List ACL RulesGOOGLECALENDAR_LIST_ACL_RULESAcción

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

Parámetros de entrada

  • page_tokenstring

    Token specifying which result page to return. Optional.

  • sync_tokenstring

    Token obtained from the nextSyncToken field returned on the last page of a previous list operation. It makes the result of this list operation contain only entries that have changed since then. Optional. The default is to retrieve all entries.

  • calendar_idstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • max_resultsinteger

    Maximum number of entries returned on one result page. Optional. The default is 100.

  • show_deletedboolean

    Whether to include deleted ACLs in the result. Optional. The default is False.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List Google CalendarsGOOGLECALENDAR_LIST_CALENDARSAcción

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

Parámetros de entrada

  • page_tokenstring

    Token for the page of results to return, from a previous response.

  • sync_tokenstring

    Sync token from a previous list request to get only changed entries; showDeleted, showHidden, and pageToken are ignored if provided.

  • max_resultsinteger

    Maximum number of calendars to return per page. Max 250.

  • show_hiddenboolean

    Include calendars not typically shown in the UI.

  • show_deletedboolean

    Include deleted calendars in the result.

  • min_access_rolestring

    Minimum access role for calendars returned. Valid values: 'freeBusyReader', 'owner', 'reader', 'writer'.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Patch CalendarGOOGLECALENDAR_PATCH_CALENDARAcción

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.

Parámetros de entrada

  • summarystringObligatorio

    New title for the calendar; cannot be an empty string.

  • locationstring

    New geographic location of the calendar (e.g., 'Paris, France').

  • timezonestring

    New IANA Time Zone Database name for the calendar (e.g., 'Europe/Zurich', 'America/New_York').

  • calendar_idstringObligatorio

    Identifier of the Google Calendar to update; use 'primary' for the main calendar or a specific ID.

  • descriptionstring

    New description for the calendar.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Patch EventGOOGLECALENDAR_PATCH_EVENTAcción

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.

Parámetros de entrada

  • summarystring

    New title for the event.

  • end_timestring

    New end time (RFC3339 timestamp, e.g., '2024-07-01T11:00:00-07:00'). Uses `timezone` if provided, otherwise UTC. For all-day events, use YYYY-MM-DD format (exclusive end date).

  • event_idstringObligatorio

    Identifier of the event to update.

  • locationstring

    New geographic location (physical address or virtual meeting link).

  • timezonestring

    IANA Time Zone Database name for start/end times (e.g., 'America/Los_Angeles'). Used if `start_time` and `end_time` are provided and not all-day dates; defaults to UTC if unset.

  • attendeesstring[]

    List of email addresses for attendees. Replaces existing attendees. Provide an empty list to remove all.

  • start_timestring

    New start time (RFC3339 timestamp, e.g., '2024-07-01T10:00:00-07:00'). Uses `timezone` if provided, otherwise UTC. For all-day events, use YYYY-MM-DD format.

  • calendar_idstringObligatorio

    Identifier of the calendar. Use 'primary' for the primary calendar of the logged-in user. To find other calendar IDs, use the `calendarList.list` method.

  • descriptionstring

    New description for the event; can include HTML.

  • send_updatesstring

    Whether to send update notifications to attendees: 'all', 'externalOnly', or 'none'. Uses default user behavior if unspecified.

  • max_attendeesinteger

    Maximum attendees in response; does not affect invited count. If more, response includes organizer only. Must be positive.

  • rsvp_responsestring

    RSVP response status for the authenticated user. Updates only the current user's response status without affecting other attendees. Possible values: 'needsAction', 'declined', 'tentative', 'accepted'.

  • supports_attachmentsboolean

    Client application supports event attachments. Set to `True` if so.

  • conference_data_versioninteger

    API client's conference data support version. Set to 1 to manage conference details (e.g., Google Meet links); 0 (default) ignores conference data.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Quick Add EventGOOGLECALENDAR_QUICK_ADDAcción

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 direct attendee addition or recurring events, and `calendar id` must be valid if not 'primary'.

Parámetros de entrada

  • textstring

    Natural language input describing the event; Google Calendar parses this for event details like title, date, and time.

  • calendar_idstring

    Identifier of the calendar for the event. Use 'primary' for the main calendar, or provide a specific calendar ID (e.g., email address).

  • send_updatesstringenum

    Controls whether email notifications about the event creation are sent to attendees.

    allexternalOnlynone

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Remove attendee from eventGOOGLECALENDAR_REMOVE_ATTENDEEAcción

Removes an attendee from a specified event in a google calendar; the calendar and event must exist.

Parámetros de entrada

  • event_idstringObligatorio

    Unique identifier of the event.

  • calendar_idstring

    Identifier of the Google Calendar to which the event belongs; 'primary' signifies the user's main calendar.

  • attendee_emailstringObligatorio

    Email address of the attendee to remove; if the email does not match an existing attendee, the event remains unchanged.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

List SettingsGOOGLECALENDAR_SETTINGS_LISTAcción

Returns all user settings for the authenticated user.

Parámetros de entrada

  • pageTokenstring

    Token specifying which result page to return.

  • syncTokenstring

    Token obtained from the nextSyncToken field returned on the last page of results from the previous list request. It makes the result of this list request contain only entries that have changed since then. If the syncToken expires, the server will respond with a 410 GONE response code and the client should clear its storage and perform a full synchronization without any syncToken.

  • maxResultsinteger

    Maximum number of entries returned on one result page. By default the value is 100 entries. The page size can never be larger than 250 entries.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Watch SettingsGOOGLECALENDAR_SETTINGS_WATCHAcción

Watch for changes to settings resources.

Parámetros de entrada

  • idstringObligatorio

    A UUID or similar unique string that identifies this channel.

  • typestringObligatorio

    The type of delivery mechanism used for this channel. Valid values are "web_hook" (or "webhook").

  • tokenstring

    An arbitrary string delivered to the target address with each notification delivered over this channel.

  • paramsobject

    Additional parameters controlling delivery channel behavior.

  • addressstringObligatorio

    The address where notifications are delivered for this channel.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Sync EventsGOOGLECALENDAR_SYNC_EVENTSAcción

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.

Parámetros de entrada

  • pageTokenstring

    Token for paginating results, from a previous response's `nextPageToken`.

  • sync_tokenstring

    Token for incremental sync, retrieving only changes since issued. A 410 GONE response indicates an expired token, requiring a full sync.

  • calendar_idstring

    Google Calendar identifier; 'primary' refers to the authenticated user's main calendar.

  • event_typesstring[]

    Filters events by specified types (e.g., 'default', 'focusTime', 'outOfOffice', 'workingLocation'). All types returned if omitted.

  • max_resultsinteger

    Max events per page (max 2500); Google Calendar's default is used if unspecified.

  • single_eventsboolean

    If True, expands recurring events into individual instances (excluding master event); otherwise, Google's default handling applies.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update ACL RuleGOOGLECALENDAR_UPDATE_ACL_RULEAcción

Updates an access control rule for the specified calendar.

Parámetros de entrada

  • rolestringObligatorio

    The role assigned to the scope. Possible values are: - "none" - Provides no access. - "freeBusyReader" - Provides read access to free/busy information. - "reader" - Provides read access to the calendar. Private events will appear to users with reader access, but event details will be hidden. - "writer" - Provides read and write access to the calendar. Private events will appear to users with writer access, and event details will be visible. - "owner" - Provides ownership of the calendar. This role has all of the permissions of the writer role with the additional ability to see and manipulate ACLs.

  • rule_idstringObligatorio

    ACL rule identifier.

  • calendar_idstringObligatorio

    Calendar identifier. To retrieve calendar IDs call the calendarList.list method. If you want to access the primary calendar of the currently logged in user, use the "primary" keyword.

  • send_notificationsboolean

    Whether to send notifications about the calendar sharing change. Note that there are no notifications on access removal. Optional. The default is True.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Update Google eventGOOGLECALENDAR_UPDATE_EVENTAcción

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.

Parámetros de entrada

  • summarystring

    Summary (title) of the event.

  • event_idstringObligatorio

    The unique identifier of the event to be updated.

  • locationstring

    Geographic location of the event as free-form text.

  • timezonestring

    IANA timezone name (e.g., 'America/New_York'). Required if datetime is naive. If datetime includes timezone info (Z or offset), this field is optional and defaults to UTC.

  • attendeesstring[]

    List of attendee emails (strings).

  • eventTypestringenum

    Type of the event, immutable post-creation. Supported types: 'birthday' (all-day with annual recurrence), 'default' (regular event), 'focusTime' (focus-time event), 'outOfOffice' (out-of-office event), 'workingLocation' (working location event). Note: 'fromGmail' events cannot be created via API.

    birthdaydefaultfocusTimeoutOfOfficeworkingLocation
  • recurrencestring[]

    List of RRULE, EXRULE, RDATE, EXDATE lines for recurring events. Supported frequencies are DAILY, WEEKLY, MONTHLY, YEARLY.

  • visibilitystringenum

    Event visibility: 'default', 'public', 'private', or 'confidential'.

    defaultpublicprivateconfidential
  • calendar_idstring

    Identifier of the Google Calendar where the event resides. The value 'primary' targets the user's primary calendar.

  • descriptionstring

    Description of the event. Can contain HTML. Optional.

  • send_updatesboolean

    Defaults to True. Whether to send updates to the attendees.

  • transparencystringenum

    'opaque' (busy) or 'transparent' (available).

    opaquetransparent
  • start_datetimestringObligatorio

    Naive date/time (YYYY-MM-DDTHH:MM:SS) with NO offsets or Z. e.g. '2025-01-16T13:00:00'

  • guests_can_modifyboolean

    If True, guests can modify the event.

  • create_meeting_roomboolean

    If true, a Google Meet link is created and added to the event. CRITICAL: As of 2024, this REQUIRES a paid Google Workspace account ($13+/month). Personal Gmail accounts will fail with 'Invalid conference type value' error. Solutions: 1) Upgrade to Workspace, 2) Use domain-wide delegation with Workspace user, 3) Use the new Google Meet REST API, or 4) Create events without conferences. See https://github.com/googleapis/google-api-nodejs-client/issues/3234

  • event_duration_hourinteger

    Number of hours (0-24). Increase by 1 here rather than passing 60 in `event_duration_minutes`

  • guestsCanInviteOthersboolean

    Whether attendees other than the organizer can invite others to the event.

  • event_duration_minutesinteger

    Duration in minutes (0-59 ONLY). NEVER use 60+ minutes - use event_duration_hour=1 instead. Maximum value is 59.

  • guestsCanSeeOtherGuestsboolean

    Whether attendees other than the organizer can see who the event's attendees are.

Parámetros de salida

  • dataobjectObligatorio

    Data from the action execution

  • errorstring

    Error if any occurred during the execution of the action

  • successfulbooleanObligatorio

    Whether or not the action execution was successful or not

Triggers (7)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

Attendee Response ChangedGOOGLECALENDAR_ATTENDEE_RESPONSE_CHANGED_TRIGGERTrigger

Polling trigger that fires when any attendee's RSVP changes to accepted, declined, or tentative. Returns attendee info and current status.

Configuración

  • calendarIdstring

    The unique identifier for the calendar

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • showDeletedboolean

    Whether to include deleted events in the results

Payload del evento

  • attendee_emailstring

    Email of the attendee whose RSVP changed

  • attendee_namestring

    Display name of the attendee

  • calendar_idstringObligatorio

    The calendar identifier

  • event_html_linkstring

    Link to the event in Google Calendar

  • event_idstringObligatorio

    The unique identifier of the event

  • event_summarystring

    Event title/summary

  • previous_response_statusstring

    Previous RSVP status

  • response_statusstringObligatorio

    Current RSVP status (accepted, declined, tentative)

Instrucciones

Fires when an attendee's RSVP status changes on a Google Calendar event. Use 'primary' for the main calendar or provide a specific calendar ID. Returns the attendee info, previous status, and new status (accepted, declined, or tentative).

Event Canceled or DeletedGOOGLECALENDAR_EVENT_CANCELED_DELETED_TRIGGERTrigger

Triggers when a Google Calendar event is cancelled or deleted. Returns minimal data: event_id, summary (if available), and cancellation timestamp.

Configuración

  • calendarIdstring

    The unique identifier for the calendar to monitor

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

  • cancelled_atstring

    Cancellation timestamp (from event.updated)

  • event_idstringObligatorio

    The unique identifier of the event

  • summarystring

    Event title/summary (may be missing for cancelled events)

Instrucciones

Fires when a Google Calendar event is cancelled or deleted. Use 'primary' for the main calendar or provide a specific calendar ID. Returns the event ID, title (if available), and cancellation timestamp.

Event Starting SoonGOOGLECALENDAR_EVENT_STARTING_SOON_TRIGGERTrigger

Triggers when a calendar event is within a configured number of minutes from starting. Returns event details, time remaining, attendees, and join links when available.

Configuración

  • calendarIdstring

    The unique identifier for the calendar to monitor

  • countdownWindowMinutesinteger

    Look-ahead window (in minutes) for upcoming events to evaluate

  • includeAllDayboolean

    Whether to consider all-day events (default False)

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • minutesBeforeStartinteger

    Trigger when an event is within this many minutes from starting

Payload del evento

  • attendeesobject[]

    List of attendees

  • calendar_idstringObligatorio

    The calendar identifier

  • countdown_window_minutesintegerObligatorio

    Countdown window used for this trigger

  • creator_emailstring

    Email of the event creator

  • descriptionstring

    Event description

  • event_idstringObligatorio

    The unique identifier of the event

  • hangout_linkstring

    Google Meet link for the conference, if available

  • html_linkstring

    Link to the event in Google Calendar

  • locationstring

    Event location

  • minutes_until_startnumber

    Minutes remaining until event starts (>= 0)

  • organizer_emailstring

    Email of the event organizer

  • start_timestring

    Event start time in ISO format

  • start_timestampnumber

    Event start time as UNIX epoch timestamp (UTC)

  • summarystring

    Event title/summary

Instrucciones

Fires when a Google Calendar event is about to start. Configure how many minutes before the start time to trigger (default: 10 minutes). Returns the event details, time until start, and meeting links if available.

Calendar Event ChangesGOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CHANGE_TRIGGERTrigger

**SOON TO BE DEPRECATED** - Use Calendar Event Sync (polling trigger) instead. Real-time webhook trigger for calendar event changes. Returns event metadata only. For full event data, use Calendar Event Sync (polling trigger).

Configuración

  • calendar_idstring

    The unique identifier for the calendar

  • ttlinteger

    The time-to-live in seconds for the notification channel

Payload del evento

  • channel_idstringObligatorio

    The unique identifier passed to identify this channel

  • resource_idstringObligatorio

    The unique identifier of the resource

  • resource_statestringObligatorio

    The state of the resource

  • resource_urlstringObligatorio

    The url for the resource

Event CreatedGOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_CREATED_TRIGGERTrigger

Polling trigger that fires when a new calendar event is created. Returns event ID, summary, start/end times, and organizer info.

Configuración

  • calendarIdstring

    The unique identifier for the calendar

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • showDeletedboolean

    Whether to include deleted events in the results

Payload del evento

  • calendar_idstringObligatorio

    The calendar identifier

  • end_timestring

    Event end time in ISO format

  • event_idstringObligatorio

    The unique identifier of the event

  • organizer_emailstring

    Email of the event organizer

  • organizer_namestring

    Name of the event organizer

  • start_timestring

    Event start time in ISO format

  • summarystring

    Event title/summary

Instrucciones

Fires when a new event is created on a Google Calendar. Use 'primary' for the main calendar or provide a specific calendar ID. Returns the event ID, title, start/end times, and organizer details.

Calendar Event SyncGOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_SYNC_TRIGGERTrigger

Polling trigger that returns full event data including details, attendees, and metadata. For real-time notifications with basic info, use Calendar Event Changes (webhook).

Configuración

  • calendarIdstring

    The unique identifier for the calendar

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • showDeletedboolean

    Whether to include deleted events in the results

Payload del evento

  • attendeesobject[]

    List of attendees

  • calendar_idstringObligatorio

    The calendar identifier

  • conference_dataobject

    Conference data structure containing details about the meeting

  • created_atstring

    When the event was created

  • creator_emailstring

    Email of the event creator

  • creator_namestring

    Name of the event creator

  • descriptionstring

    Event description

  • end_timestring

    Event end time in ISO format

  • event_idstringObligatorio

    The unique identifier of the event

  • event_typestringObligatorio

    Type of change: created, updated, or deleted

  • hangout_linkstring

    Google Meet link for the conference, if available

  • html_linkstring

    Link to the event in Google Calendar

  • locationstring

    Event location

  • organizer_emailstring

    Email of the event organizer

  • organizer_namestring

    Name of the event organizer

  • recurring_event_idstring

    ID of recurring event if applicable

  • start_timestring

    Event start time in ISO format

  • statusstring

    Event status (confirmed, tentative, cancelled)

  • summarystring

    Event title/summary

  • updated_atstring

    When the event was last updated

  • visibilitystring

    Event visibility

Instrucciones

Fires when any calendar event is created, updated, or deleted. Use 'primary' for the main calendar or provide a specific calendar ID. Returns complete event data including title, description, attendees, times, location, and conference links.

Event UpdatedGOOGLECALENDAR_GOOGLE_CALENDAR_EVENT_UPDATED_TRIGGERTrigger

Triggers when an existing Google Calendar event is modified. Returns the event ID, change type, and the specific fields that changed with their previous and new values.

Configuración

  • calendarIdstring

    The unique identifier for the calendar

  • intervalnumber

    Periodic Interval to Check for Updates & Send a Trigger in Minutes

  • showDeletedboolean

    Whether to include deleted (cancelled) events in the results

  • tracked_fieldsstring[]

    List of event fields to track for changes. start and end are compared as RFC3339 strings (preferring dateTime over date). Attendees are compared by email, displayName, responseStatus, and optional flag.

Payload del evento

  • calendar_idstringObligatorio

    The calendar identifier

  • change_typestring

    Type of change. Always 'updated' for this trigger

  • event_idstringObligatorio

    The unique identifier of the event

  • updated_atstring

    When the event was last updated (RFC3339)

  • updated_fieldsobjectObligatorio

    Dictionary of changed fields with old and new values

Instrucciones

Fires when an existing event on a Google Calendar is modified. Use 'primary' for the main calendar or provide a specific calendar ID. Returns the event ID and the specific fields that changed with their previous and new values.