Google Calendar

🚀 Quickstart
📚 Google Calendar Integration Guides
🧩 Pre-built syncs & actions for Google Calendar
Access Control
Attendees
Calendars
Events
Scheduling
Settings
Users

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

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.

Access Control

Function name	Description	Type	Source code
`create-acl-rule`	Creates an access control rule granting calendar access	Action	🔗 Github
`delete-acl-rule`	Deletes an access control rule	Action	🔗 Github
`get-acl-rule`	Returns an access control rule by rule ID	Action	🔗 Github
`list-acl-rules`	Returns the rules in the access control list for a calendar	Action	🔗 Github
`update-acl-rule`	Updates an access control rule	Action	🔗 Github

Attendees

Function name	Description	Type	Source code
`add-attendee`	Adds an attendee to an existing calendar event	Action	🔗 Github
`remove-attendee`	Removes an attendee from an existing calendar event	Action	🔗 Github
`update-attendee-response`	Updates an attendee’s response status for an event	Action	🔗 Github

Calendars

Function name	Description	Type	Source code
`clear-calendar`	Clears a primary calendar by deleting all events	Action	🔗 Github
`create-calendar`	Creates a new secondary calendar with the specified title	Action	🔗 Github
`delete-calendar`	Deletes a secondary calendar	Action	🔗 Github
`get-calendar-list-entry`	Returns a calendar from the user’s calendar list	Action	🔗 Github
`get-calendar`	Returns metadata for a calendar by calendar ID	Action	🔗 Github
`insert-calendar-to-list`	Inserts an existing calendar into the user’s calendar list	Action	🔗 Github
`list-calendars`	Returns all calendars on the user’s calendar list	Action	🔗 Github
`remove-calendar-from-list`	Removes a calendar from the user’s calendar list	Action	🔗 Github
`update-calendar-list-entry`	Updates an existing calendar on the user’s calendar list	Action	🔗 Github
`update-calendar`	Updates metadata for a calendar	Action	🔗 Github
`calendars`	Sync the calendars list of the user	Sync	🔗 Github

Events

Function name	Description	Type	Source code
`create-all-day-event`	Creates an all-day event on a calendar	Action	🔗 Github
`create-event`	Creates a new event on a calendar	Action	🔗 Github
`create-recurring-event`	Creates a recurring event with RRULE specification	Action	🔗 Github
`delete-event`	Deletes an event from a calendar	Action	🔗 Github
`get-event-instances`	Returns instances of a recurring event	Action	🔗 Github
`get-event`	Returns an event based on its calendar and event ID	Action	🔗 Github
`import-event`	Imports an event as a private copy using iCalendar UID	Action	🔗 Github
`list-events`	Returns events on a specified calendar with optional filtering	Action	🔗 Github
`list-upcoming-events`	Returns upcoming events starting from now	Action	🔗 Github
`move-event`	Moves an event to another calendar changing its organizer	Action	🔗 Github
`patch-event`	Partially updates an event with only provided fields	Action	🔗 Github
`quick-add-event`	Creates an event based on a simple text string like a natural language input	Action	🔗 Github
`search-events`	Searches for events matching a text query across calendars	Action	🔗 Github
`update-event`	Updates an existing event on a calendar	Action	🔗 Github
`events`	Sync calendar events on the primary calendar going back one month and save the entire object as specified by the Google API	Sync	🔗 Github

Scheduling

Function name	Description	Type	Source code
`find-free-slots`	Finds available time slots across calendars within a time range	Action	🔗 Github
`query-free-busy`	Returns free/busy information for a set of calendars	Action	🔗 Github

Settings

Function name	Description	Type	Source code
`get-colors`	Returns the color definitions for calendars and events	Action	🔗 Github
`get-setting`	Returns a single user setting by setting ID	Action	🔗 Github
`list-settings`	Returns all user settings for the authenticated user	Action	🔗 Github

Users

Function name	Description	Type	Source code
`settings`	Fetch all user settings from Google Calendar	Action	🔗 Github
`whoami`	description: Fetch current user information	Action	🔗 Github

Google Analytics Google Chat

⌘I

API Guides

APIs & Integrations

🚀 Quickstart

📚 Google Calendar Integration Guides

🧩 Pre-built syncs & actions for Google Calendar

Access Control

Attendees

Calendars

Events

Scheduling

Settings

Users

API Guides

APIs & Integrations

​🚀 Quickstart

​📚 Google Calendar Integration Guides

​🧩 Pre-built syncs & actions for Google Calendar

​Access Control

​Attendees

​Calendars

​Events

​Scheduling

​Settings

​Users

🚀 Quickstart

📚 Google Calendar Integration Guides

🧩 Pre-built syncs & actions for Google Calendar

Access Control

Attendees

Calendars

Events

Scheduling

Settings

Users