Google Calendar

Integrate your application with the Google Calendar API

🚀 Quickstart

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

1. 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.

2. 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.

3. 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

   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>"
   

   Node

   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.

4. 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

---