Notion

Integrate your application with the Notion API

🚀 Quickstart

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

1. Create the integration

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

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

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

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

   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: '/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.

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.

📚 Notion Integration Guides

Nango maintained guides for common use cases.

• How to register your own Notion OAuth app Register an OAuth app with Notion and obtain credentials to connect it to Nango

Official docs: Notion API documentation

🧩 Pre-built syncs & actions for Notion

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

Contents

Function name	Description	Type	Source code
fetch-content-metadata	Retrieve the entity type as well as an id for a Notion entity to later call fetch-database or fetch-rich-page based on the type.	Action	🔗 Github
content-metadata	Sync pages and databases metadata to further fetch the content using a dedicated action	Sync	🔗 Github

Databases

Function name	Description	Type	Source code
create-database-row	Create a new row in a specified Notion database. The properties are mapped to Notion-compatible formats based on the database schema. Supported property types include: - title (string): Creates a title property. - select (string): Creates a select property. - multi_select (array of strings): Creates a multi-select property. - status (string): Creates a status property. - date (string or object): Supports ISO date strings or objects with a start field. - checkbox (boolean): Creates a checkbox property. - number (number): Creates a number property. - url (string): Creates a URL property. - email (string): Creates an email property. - phone_number (string): Creates a phone number property. - rich_text (string): Creates a rich text property. - relation (array of IDs): Creates a relation property.	Action	🔗 Github
databases	Sync a database content with each row as an entry. Store the top level database information in the metadata to be able to reconcile the database	Sync	🔗 Github

Users

Function name	Description	Type	Source code
users	Fetches a list of users from Notion	Sync	🔗 Github

---