Google Calendar Component
Manage calendars and events in Google Calendar
Component key: google-calendar
Description
Google Calendar is a time-management and scheduling calendar service developed by Google. This component allows you to create, read, update and delete events and calendars connected to your Google account.
Connections
Google Calendar OAuth 2.0
The Google Calendar component authenticates requests through Google's OAuth service. To create a Google Calendar developer account and authenticate using Google OAuth, follow the directions here Now, you will have to configure OAuth 2.0 settings. Create a new Google Calendar connection of type OAuth 2.0.
- For Client ID and Client Secret enter the values that you got from the Google Cloud Platform auth settings.
- For Scopes choose from the list found on the Google docs
| Input | Notes | Example |
|---|---|---|
| Authorize URL | The OAuth 2.0 Authorization URL for Google Calendar | https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&prompt=consent |
| Client ID | Provide a string value for the client Id of your OAuth 2.0 application. | |
| Client Secret | Provide a string value for the client secret of your OAuth 2.0 application. | |
| Scopes | A space-delimited set of one or more scopes to get the user's permission to access. | https://www.googleapis.com/auth/calendar |
| Token URL | The OAuth 2.0 Token URL for Google Calendar | https://oauth2.googleapis.com/token |
Data Sources
Select Calendar
A list of selectable calendars | key: selectCalendar | type: picklist
| Input | Notes | Example |
|---|---|---|
| Connection |
{
"result": [
{
"label": "Holidays in United States",
"key": "en.usa#holiday@group.v.calendar.google.com"
}
]
}
Select Event
A list of selectable events | key: selectEvent | type: picklist
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Calendar ID to get events from. | en.usa#holiday@group.v.calendar.google.com |
| Connection |
{
"result": [
{
"label": "New Year's Day (2020-01-01 to 2020-01-02)",
"key": "20200101_q8ue475rr4p7opsd4c0lr7g5pg"
}
]
}
Actions
Create Calendar
Create a new calendar | key: createCalendar
| Input | Notes | Example |
|---|---|---|
| Description | Provide a string value for the description. | This is an example description |
| Connection | ||
| Summary | Provide a string value for the summary. | This is an example summary. |
| Time Zone | Provide a valid value for the timezone of the event. For a complete list of timezones refer to the google docs. | America/Chicago |
Create Event
Create a new event in a given calendar | key: createEvent
| Input | Notes | Example |
|---|---|---|
| Add Conference Event | Creates a Google Meet link when set to true. | false |
| Attendees | Provide an array of attendee objects as described at https://developers.google.com/calendar/api/v3/reference/events/insert | |
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection | ||
| Description | Provide a string value for the description. | This is an example description |
| End Time | Provide a date time value for the ending time of the event. | 2015-05-28T17:00:00-07:00 |
| Event Location | Provide a string value for the location of the event. | The Rec Center |
| Remind Method | This field is only required if useDefaultReminder is set to false. | |
| Remind Before (minutes) | This field is only required if useDefaultReminder is set to false. | 30 |
| Send Updates | Whether to send notifications about the creation of the new event. Note that some emails might still be sent. The default is false. | |
| Start Time | Provide a date time value for the starting time of the event. | 2015-05-28T17:00:00-07:00 |
| Summary | Provide a string value for the summary. | This is an example summary. |
| Time Zone | Provide a valid value for the timezone of the event. For a complete list of timezones refer to the google docs. | America/Chicago |
| Default Reminder | If this field is true, the event will use the default reminder settings. | false |
Delete Calendar
Delete an existing calendar by Id | key: deleteCalendar
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection |
Delete Event
Delete an event by an Id | key: deleteEvent
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection | ||
| Event Id | Provide the unique identifier of the event. | 20200101_q8ue475rr4p7opsd4c0lr7g5pg |
| Send Updates | Guests who should receive notifications about the deletion of the event. |
Get Calendar
Get the information and metadata of a calendar by Id | key: getCalendar
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection |
Get Event
Get the information and metadata of an event by Id | key: getEvent
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection | ||
| Event Id | Provide the unique identifier of the event. | 20200101_q8ue475rr4p7opsd4c0lr7g5pg |
List Calendars
List all calendars | key: listCalendar
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Fetch All | If true, fetches all pages of results, ignoring the 'Max Results' and 'Page Token' inputs. | false |
| Max Results | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 250. | 20 |
| Page Token | Specify the pagination token that's returned by a previous request to retrieve the next page of results | lslTXFcbLQKkb0vP9Kgh5hy0Y0OnC7Z9ZPHPwPmMnxSk3eiDRMkct7D8E |
List Events
List all events in a given calendar | key: listEvents
| Input | Notes | Example |
|---|---|---|
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Fetch All | If true, fetches all pages of results, ignoring the 'Max Results' and 'Page Token' inputs. | false |
| Connection | ||
| Max Attendees | 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. | |
| Max Results | Provide an integer value for the maximum amount of results that will be returned. Provide a value from 1 to 250. | 20 |
| Order By | The order of the events returned in the result. Optional. The default is an unspecified, stable order. | |
| Page Token | Specify the pagination token that's returned by a previous request to retrieve the next page of results | lslTXFcbLQKkb0vP9Kgh5hy0Y0OnC7Z9ZPHPwPmMnxSk3eiDRMkct7D8E |
| Query | Free text search terms to find events that match these terms in the following fields: summary, description, location, attendee's displayName, attendee's email | |
| Show Deleted | false | |
| Show Hidden Invitations | false | |
| Single Events | Whether to expand recurring events into instances and only return single one-off events and instances of recurring events, but not the underlying recurring events themselves. Optional. The default is False. | false |
| Sync Token | Specify the token for syncing the latest resources that have been modified since the last sync request | lslTXFcbLQKkb0vP9Kgh5hy0Y0OnC7Z9ZPHPwPmMnxSk3eiDRMkct7D8E |
| Time Max | Upper bound for an event's start time to filter by. Must be a timestamp with timezone offset, 2011-06-03T10:00:00-07:00 | |
| Time Min | Lower bound for an event's end time to filter by. | |
| Time Zone | Time zone used in the response. Optional. | |
| Updated Min | Lower bound for an event's last modification time (as a RFC 3339 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. |
Raw Request
Send raw HTTP request to Google Calendar | key: rawRequest
| Input | Notes | Example |
|---|---|---|
| Connection | ||
| Data | The HTTP body payload to send to the URL. | {"exampleKey": "Example Data"} |
| File Data | File Data to be sent as a multipart form upload. | [{key: "example.txt", value: "My File Contents"}] |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Form Data | The Form Data to be sent as a multipart form upload. | [{"key": "Example Key", "value": new Buffer("Hello World")}] |
| Header | A list of headers to send with the request. | User-Agent: curl/7.64.1 |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Method | The HTTP method to use. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Timeout | The maximum time that a client will await a response to its request | 2000 |
| URL | Input the path only (/colors), The base URL is already included (https://www.googleapis.com/calendar/v3). For example, to connect to https://www.googleapis.com/calendar/v3/colors, only /colors is entered in this field. | /colors |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Update Event
Update the information and metadata of an existing event | key: updateEvent
| Input | Notes | Example |
|---|---|---|
| Attendees | Provide an array of attendee objects as described at https://developers.google.com/calendar/api/v3/reference/events/insert | |
| Calendar Id | Provide a string value for the id of the calendar. | en.usa#holiday@group.v.calendar.google.com |
| Connection | ||
| Description | Provide a string value for the description. | This is an example description |
| End Time | Provide a date time value for the ending time of the event. | 2015-05-28T17:00:00-07:00 |
| Event Id | Provide the unique identifier of the event. | 20200101_q8ue475rr4p7opsd4c0lr7g5pg |
| Event Location | Provide a string value for the location of the event. | The Rec Center |
| Remind Method | This field is only required if useDefaultReminder is set to false. | |
| Remind Before (minutes) | This field is only required if useDefaultReminder is set to false. | 30 |
| Send Updates | Guests who should receive notifications about the event update (for example, title changes, etc.). | |
| Start Time | Provide a date time value for the starting time of the event. | 2015-05-28T17:00:00-07:00 |
| Summary | Provide a string value for the summary. | This is an example summary. |
| Time Zone | Provide a valid value for the timezone of the event. For a complete list of timezones refer to the google docs. | America/Chicago |
| Default Reminder | If this field is true, the event will use the default reminder settings. | false |
Changelog
2025-07-31
Modernized component with inline data sources for selecting Calendars and Events.
2025-04-26
Enhanced event management capabilities:
- Added "Send Updates" option to Update and Delete Event actions
- Implemented email invitations to attendees on Create Event
- Added Conference Event field support
- Fixed attendee input handling