Google Calendar - Nango Docs

🚀 Quickstart
📚 Google Calendar Integration Guides
🧩 Pre-built syncs & actions for Google Calendar
ACL
Calendar
Calendar List
CalendarList
Calendars
Channels
Events
Settings
Users
Others

🚀 Quickstart

Connect to Google Calendar with Nango and see data flow in 2 minutes.

Create an integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Google Calendar.

Nango has credentials you can use for testing. Activate them in the dashboard.

Authorize Google Calendar

Go to Connections -> Add Test Connection -> Authorize, then log in to Google Calendar. Later, you’ll let your users do the same directly from your app.

Call the Google Calendar API

Let’s make your first request to the Google Calendar API (fetch a list of calendars). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/calendar/v3/users/me/calendarList?maxResults=10" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/calendar/v3/users/me/calendarList',
    params: { maxResults: 10 },
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials dynamically via the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Google Calendar Integration Guides

Nango maintained guides for common use cases.

How to register your own Google Calendar OAuth app
Register an OAuth app with Google Calendar and obtain credentials to connect it to Nango
How to setup webhooks with Google Calendar on Nango
Set up Google Calendar push notifications using notification channels to receive real-time calendar and event updates

Official docs: Google Calendar API documentation

🧩 Pre-built syncs & actions for Google Calendar

Enable them in your dashboard. Extend and customize to fit your needs.

ACL

Function name	Description	Type	Source code
`delete-acl-rule`	Delete an access control rule from a calendar	Action	🔗 Github
`get-acl-rule`	Get an access control rule by ID	Action	🔗 Github
`list-acl-rules`	List ACL rules for a calendar with pagination support	Action	🔗 Github
`update-acl-rule`	Update an access control rule	Action	🔗 Github

Calendar

Function name	Description	Type	Source code
`create-acl-rule`	Create an access control rule	Action	🔗 Github
`find-free-slots`	Query free/busy data and return gaps meeting a minimum duration	Action	🔗 Github
`get-colors`	Return available calendar and event color definitions	Action	🔗 Github

Calendar List

Function name	Description	Type	Source code
`insert-calendar-to-list`	Add an existing calendar to the user’s calendar list with optional colors	Action	🔗 Github

CalendarList

Function name	Description	Type	Source code
`watch-calendar-list`	Subscribe to changes in the calendar list	Action	🔗 Github
`calendar-list`	Full sync of the user’s calendar list, including access role, colors, primary/selected flags, and deleted status.	Sync	🔗 Github

Calendars

Function name	Description	Type	Source code
`clear-calendar`	Clear a calendar by deleting all events	Action	🔗 Github
`create-calendar`	Create a new secondary Google Calendar with the specified title.	Action	🔗 Github
`delete-calendar`	Delete a secondary calendar	Action	🔗 Github
`get-calendar-list-entry`	Retrieve a calendar list entry with access role and colors	Action	🔗 Github
`get-calendar`	Get a calendar by ID	Action	🔗 Github
`list-calendar-list`	List calendars in the user’s calendar list	Action	🔗 Github
`query-free-busy`	Return free/busy blocks for one or more calendars in a time range	Action	🔗 Github
`remove-calendar-from-list`	Remove a calendar from the user’s calendar list	Action	🔗 Github
`update-calendar-list-entry`	Update a calendar list entry’s settings	Action	🔗 Github
`update-calendar`	Update a calendar’s metadata	Action	🔗 Github

Channels

Function name	Description	Type	Source code
`stop-channel`	Stop push notifications for a channel	Action	🔗 Github

Events

Function name	Description	Type	Source code
`add-attendee`	Add an attendee to an existing calendar event	Action	🔗 Github
`create-all-day-event`	Create an all-day calendar event using start and end dates	Action	🔗 Github
`create-event`	Create a calendar event	Action	🔗 Github
`create-recurring-event`	Create a recurring event with supplied start, end, and RRULE values	Action	🔗 Github
`delete-event`	Delete a calendar event	Action	🔗 Github
`get-event`	Get an event by ID from Google Calendar	Action	🔗 Github
`import-event`	Import an event as a private copy using an iCalendar UID	Action	🔗 Github
`list-event-instances`	List instances of a recurring event	Action	🔗 Github
`list-events`	List events on a calendar	Action	🔗 Github
`list-upcoming-events`	List upcoming events from now, ordered by start time	Action	🔗 Github
`move-event`	Move an event to another calendar, changing its organizer	Action	🔗 Github
`patch-event`	Partially update only provided event fields like time, location, or description	Action	🔗 Github
`quick-add-event`	Create an event from a text string	Action	🔗 Github
`remove-attendee`	Fetch an event, remove an attendee by email, and patch attendees	Action	🔗 Github
`search-events`	Search a calendar’s events by text query and optional time bounds	Action	🔗 Github
`update-attendee-response`	Fetch an event and update one attendee response status	Action	🔗 Github
`update-event`	Update a calendar event	Action	🔗 Github
`watch-events`	Subscribe to event changes on a calendar	Action	🔗 Github

Settings

Function name	Description	Type	Source code
`get-setting`	Retrieve a single Google Calendar user setting by ID	Action	🔗 Github
`list-settings`	List calendar settings	Action	🔗 Github
`settings`	Fetch all user settings across pages from Google Calendar	Action	🔗 Github
`watch-settings`	Subscribe to changes in calendar settings	Action	🔗 Github
`settings`	Sync calendar settings	Sync	🔗 Github

Users

Function name	Description	Type	Source code
`whoami`	Return the current user’s Google account ID and email	Action	🔗 Github

Others

Function name	Description	Type	Source code
`calendar-events`	Incrementally sync full Google Calendar event objects, defaulting to the primary calendar with an initial one-month lookback	Sync	🔗 Github

Google BigQuery Google Chat

⌘I

700+ APIs & Integrations

​🚀 Quickstart

​📚 Google Calendar Integration Guides

​🧩 Pre-built syncs & actions for Google Calendar

​ACL

​Calendar

​Calendar List

​CalendarList

​Calendars

​Channels

​Events

​Settings

​Users

​Others

🚀 Quickstart

📚 Google Calendar Integration Guides

🧩 Pre-built syncs & actions for Google Calendar

ACL

Calendar

Calendar List

CalendarList

Calendars

Channels

Events

Settings

Users

Others