How to register your own Notion OAuth app

Register an OAuth app with Notion and connect it to Nango

This guide shows you how to register your own app with Notion to obtain your OAuth credentials (client ID & secret). These are required to let your users grant your app access to their Notion account.

1. Create a Notion account

   If you don’t already have one, sign up for a Notion account.

2. Create a new integration

   1. Go to My Integrations in your Notion account.
   2. Click + New integration.
   3. Select Public as the integration type, then fill in the integration details. For the Redirect URIs, add https://api.nango.dev/oauth/callback.
   4. Click Save.
3. Obtain API credentials

   1. After saving, click Configure integration settings.
   2. Under the Configuration tab, copy your OAuth Client ID and OAuth Client Secret. You’ll need these when configuring your integration in Nango.
   3. Under the Capabilities section, select the capabilities your integration requires.
4. Next

   Follow the Quickstart.

When creating a Notion OAuth app, it is set to Internal by default. You need to make it Public to initiate an OAuth flow with users. Only then will you be able to obtain the OAuth client ID/secret and register your callback URL.

The Notion OAuth API doesn’t support refreshing tokens, and so doesn’t return a refresh token. The access token never expires.

No OAuth scope is required by default for Notion integrations.

After authorization, users need to explicitly share specific pages or databases with your integration before you can access them.

For more details on Notion’s OAuth implementation, see Notion’s authentication documentation and OAuth setup guide.

---