Notion - Nango Docs

Overview

Pre-built tooling

Pre-built use-cases

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

Tools	Status
Pre-built use-cases	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	✅
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Pre-built use cases

Endpoint	Description	Readme
`GET /contents/single`	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.	🔗
`GET /contents`	Sync pages and databases metadata to further fetch the content using a dedicated action	🔗

Endpoint	Description	Readme
`GET /databases/single`	Fetch a specific Notion database by passing in the database id. This action fetches the database and outputs an object. Note that this should be used for small databases.	🔗
`GET /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	🔗

Endpoint	Description	Readme
`GET /pages/single`	Fetch a specific page in Notion by passing a pageId. This action fetches a page, and its content and converts it into a full markdown. It transforms images, tables, uploaded files, etc., into their markdown counterparts, providing a complete markdown.	🔗

Endpoint	Description	Readme
`GET /users`	Fetches a list of users from Notion	🔗

Not seeing the use case you need? Build your own independently.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Contribute useful links by editing this page

API gotchas

The Notion OAuth API doesn’t support refreshing tokens, and so doesn’t return a refresh token. The access token never expires.
Your Notion OAuth app will have the status “internal”. You need to make it “public” to be able to initiate an OAuth flow. Only then, you will be able to get the OAuth client ID/secret and register your callback URL.
No OAuth scope is required by default.
Notion SCIM is an enterprise only API that uses an API token. See the Notion docs for more information

Contribute API gotchas by editing this page

Connect to notion-scim

Guide to connect to notion-scim using Nango Connect.

Was this page helpful?

NextCloud Odoo

On this page

Overview
Pre-built tooling
Pre-built use cases
Access requirements
Setup guide
Useful links
API gotchas

APIs & Integrations

​Overview

Pre-built tooling

Pre-built use-cases

Access requirements

Setup guide

Useful links

API gotchas

​Pre-built tooling

​Pre-built use cases

​Access requirements

​Setup guide

​Useful links

​API gotchas

Connect to notion-scim

Overview

Pre-built tooling

Pre-built use cases

Access requirements

Setup guide

Useful links

API gotchas