Prerequisites
- A Notion workspace owner role (only owners can publish public integrations).
Set up the Notion integration
1
Create the integration
Go to notion.so/my-integrations and click + New integration.
2
Switch type to Public
The default is Internal. Change Integration Type to Public so other workspaces can install it via OAuth.
3
Add the redirect URI
Set the OAuth Redirect URI to:
4
Configure capabilities
Notion has no OAuth scope parameter—access is controlled by capabilities you check on the integration page (read content, update content, insert content, read user info). Enable only what pipelines need.
Connect
1
Authorize
From Integrations → Notion, click Connect, sign in, and select which workspace and pages to share with the integration.
Gotchas
- No refresh tokens. Notion’s OAuth access token doesn’t expire, but there’s also no rotation flow—if you need to revoke, do it on Notion’s side and reconnect.
- Page-level sharing required. After OAuth, users must explicitly share each page or database with the integration. Pages that haven’t been shared are invisible, even with broad capabilities.
- Only workspace owners can publish a public integration. Members can’t.