Google Calendar

🚀 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
Google App & Security Review Pass Google’s OAuth app verification to go to production

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.

Others

Function name	Description	Type	Source code
`add-attendee`	Add an attendee to an existing calendar event	Action	🔗 Github
`clear-calendar`	Clear a calendar by deleting all events	Action	🔗 Github
`create-acl-rule`	Create an access control rule	Action	🔗 Github
`create-all-day-event`	Create an all-day calendar event using start and end dates	Action	🔗 Github
`create-calendar`	Create a new secondary Google Calendar with the specified title.	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-acl-rule`	Delete an access control rule from a calendar	Action	🔗 Github
`delete-calendar`	Delete a secondary calendar	Action	🔗 Github
`delete-event`	Delete a calendar event	Action	🔗 Github
`find-free-slots`	Query free/busy data and return gaps meeting a minimum duration	Action	🔗 Github
`get-acl-rule`	Get an access control rule by ID	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
`get-colors`	Return available calendar and event color definitions	Action	🔗 Github
`get-event`	Get an event by ID from Google Calendar	Action	🔗 Github
`get-setting`	Retrieve a single Google Calendar user setting by ID	Action	🔗 Github
`import-event`	Import an event as a private copy using an iCalendar UID	Action	🔗 Github
`insert-calendar-to-list`	Add an existing calendar to the user’s calendar list with optional colors	Action	🔗 Github
`list-acl-rules`	List ACL rules for a calendar with pagination support	Action	🔗 Github
`list-calendars`	List calendars in the user’s calendar list	Action	🔗 Github
`get-event-instances`	List instances of a recurring event	Action	🔗 Github
`list-events`	List events on a calendar	Action	🔗 Github
`list-settings`	List calendar settings	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
`query-free-busy`	Return free/busy blocks for one or more calendars in a time range	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
`remove-calendar-from-list`	Remove a calendar from the user’s calendar list	Action	🔗 Github
`search-events`	Search a calendar’s events by text query and optional time bounds	Action	🔗 Github
`settings`	Fetch all user settings across pages from Google Calendar	Action	🔗 Github
`stop-channel`	Stop push notifications for a channel	Action	🔗 Github
`update-acl-rule`	Update an access control rule	Action	🔗 Github
`update-attendee-response`	Fetch an event and update one attendee response status	Action	🔗 Github
`update-calendar-list-entry`	Update a calendar list entry’s settings	Action	🔗 Github
`update-calendar`	Update a calendar’s metadata	Action	🔗 Github
`update-event`	Update a calendar event	Action	🔗 Github
`watch-calendar-list`	Subscribe to changes in the calendar list	Action	🔗 Github
`watch-events`	Subscribe to event changes on a calendar	Action	🔗 Github
`watch-settings`	Subscribe to changes in calendar settings	Action	🔗 Github
`whoami`	Return the current user’s Google account ID and email	Action	🔗 Github
`events`	Incrementally sync full Google Calendar event objects, defaulting to the primary calendar with an initial one-month lookback	Sync	🔗 Github
`calendars`	Full sync of the user’s calendar list, including access role, colors, primary/selected flags, and deleted status.	Sync	🔗 Github
`settings`	Sync calendar settings	Sync	🔗 Github

Overview

900+ APIs & Integrations

🚀 Quickstart

📚 Google Calendar Integration Guides

🧩 Pre-built syncs & actions for Google Calendar

Others

​🚀 Quickstart

​📚 Google Calendar Integration Guides

​🧩 Pre-built syncs & actions for Google Calendar

​Others

🚀 Quickstart

📚 Google Calendar Integration Guides

🧩 Pre-built syncs & actions for Google Calendar

Others