Notion API wiki
Working with the Notion API?
Please add your learnings, favorite links and gotchas here by editing this page.
Using Notion with Nango
Provider template name in Nango:
Follow our quickstart to add an OAuth integration with Notion in 5 minutes.
App registration & publishing
Register your app here
By default your app is internal only, once you created it you will be able to make it public. There is no review process, unless you want to get listed in the Notion App Gallery.
- Notion API docs
- List of available Notion API OAuth scopes (Notion calls these "capabilities")
API specific gotchas
- Notion does not let you pass OAuth scopes (called "capabilities" in the Notion API) with the authorization. Instead you set them when you register your OAuth app (called "integrations" in Notion). When you add a Notion config in Nango, just pass a single whitespace as scopes: