Gmail - Nango Docs

🚀 Quickstart

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

Create the integration

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

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

Authorize Gmail

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

Call the Gmail API

Let’s make your first request to the Gmail API (fetch the profile of the currently signed-in user). This request will return basic details about the authenticated user, such as their email address and message/thread counts. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/gmail/v1/users/me/profile" \
  -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: '/gmail/v1/users/me/profile',
    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.

📚 Gmail Integration Guides

Nango maintained guides for common use cases.

How to register your own Gmail OAuth app
Register an OAuth app with Gmail and obtain credentials to connect it to Nango
How to setup webhooks with Gmail on Nango
Set up Gmail push notifications using Google Pub/Sub to receive real-time inbox updates

Official docs: Gmail API docs

🧩 Pre-built syncs & actions for Gmail

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

Emails

Function name	Description	Type	Source code
`send-email`	Send an Email using Gmail.	Action	🔗 Github
`emails`	Fetches a list of emails from gmail. Goes back default to 1 year but metadata can be set using the `backfillPeriodMs` property to change the lookback. The property should be set in milliseconds.	Sync	🔗 Github

Labels

Function name	Description	Type	Source code
`labels`	Fetches a list of labels from gmail.	Sync	🔗 Github

Others

Function name	Description	Type	Source code
`fetch-attachment`	An action used to fetch the contents of an attachment.	Action	🔗 Github

700+ APIs & Integrations

​🚀 Quickstart

​📚 Gmail Integration Guides

​🧩 Pre-built syncs & actions for Gmail

​Emails

​Labels

​Others

🚀 Quickstart

📚 Gmail Integration Guides

🧩 Pre-built syncs & actions for Gmail

Emails

Labels

Others