Google Calendar - Nango Docs

🚀 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

🧩 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
`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

​🚀 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