Notion - Nango Docs

🚀 Quickstart

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

Create the integration

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

Authorize Notion

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

Call the Notion API

Let’s make your first request to the Notion API (fetch a list of users). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1/users" \
  -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: '/v1/users',
  providerConfigKey: '<INTEGRATION-ID>',
  connectionId: '<CONNECTION-ID>'
});

console.log(JSON.stringify(res.data, 2, null));

Or fetch credentials with 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.

🧩 Pre-built syncs & actions for Notion

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

Others

Function name	Description	Type	Source code
`content-metadata`	Sync page and data source metadata for broad Notion content discovery.	Sync	🔗 Github
`data-source-entries`	Sync page entries from a Notion data source with properties and timestamps	Sync	🔗 Github
`data-source-templates`	Sync templates available for a Notion data source	Sync	🔗 Github
`data-sources`	Sync Notion data source definitions and schema metadata.	Sync	🔗 Github
`users`	Sync Notion users and bots visible to the integration.	Sync	🔗 Github

​🚀 Quickstart

​📚 Notion Integration Guides

​🧩 Pre-built syncs & actions for Notion

​Others

🚀 Quickstart

📚 Notion Integration Guides

🧩 Pre-built syncs & actions for Notion

Others