Documentation Index
Fetch the complete documentation index at: https://docs.alterauth.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Connect your users to Notion for notes, documents, databases, and knowledge management.| Property | Value |
|---|---|
| Provider ID | notion |
| Category | Productivity |
| PKCE | Not supported |
| Token refresh | Automatic (rolling refresh tokens) |
| Redirect URI | Shown in Developer Portal |
Notion permissions are granted per-page during authorization. Alter Vault automatically handles token refresh using Notion’s rolling refresh tokens.
Step 1: Create a Notion Integration
Go to Notion Integrations
Navigate to notion.so/my-integrations and sign in.
Add the redirect URI
Under OAuth Domain & URIs, add the Redirect URI from the Developer Portal to the Redirect URIs field.
Step 2: Add to Alter Vault
Open the Developer Portal
Go to portal.alterauth.com and navigate to your app.
Enter credentials
- Client ID: Paste your Notion OAuth client ID
- Client Secret: Paste your Notion OAuth client secret
Available Scopes
Notion does not use traditional OAuth scopes. Instead, permissions are granted per-page by the user during the authorization flow. The user selects which pages and databases to share with your integration.Notes
- Notion uses Internal and Public integration types. You must use Public for OAuth.
- Notion uses rolling refresh tokens. Each refresh generates a new access token and refresh token, invalidating the old one. Alter Vault handles this automatically.
- Users grant access to specific pages and databases during authorization, not via scopes.
- See the Notion OAuth documentation for more details.