Skip to main content
  • 🚀 Quickstart
  • 🧑‍💻 OAuth app setup
  • 🚨 API gotchas
1

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

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

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>"
Or fetch credentials dynamically via the Node SDK or API.
✅ You’re connected! Check the Logs tab in Nango to inspect requests.
Next step: Embed the auth flow in your app to let your users connect their Gmail accounts.
Questions? Join us in the Slack community.