Notion
Difficulty: Self-serveReaching public launch is mostly self-serve. You create a public connection in Notion's Developer portal, get an OAuth client ID and secret, and Notion's docs say the connection works through OAuth without a Marketplace listing. The only formal review is the optional Marketplace listing, which takes 5–10 business days. One line in the docs (the authorization URL field fills in after you submit for review) means you should check in the portal whether submitting is needed before outside workspaces can install.
- Your work
- 30–90 min
- Waiting on Notion
- None
- First user connects
- Today, in about 30 minutes
Plan
12 tasksSetupBefore you start
BuildYour workspace
work 30–60 min · wait noneYou, from your development workspace or any workspace you selected
LaunchPublic launch
work 0–30 min · wait noneAny Notion user who has full access to the pages they share. Connections set to 'Selected workspaces only' stay limited to the workspaces you chose.
Why self-serve
- Tier
- Notion's docs say public connections work independently of Marketplace listings, so OAuth installs don't depend on the reviewed listing. Confidence is medium because of the wording about submitting for review.
- Using Composio?
- Composio has a managed Notion OAuth app, so you can prototype before you create your own public connection. Register your own before launch so your connection name and logo appear on Notion's consent screen. The separate NOTION_MCP toolkit requires your own OAuth app.NOTION
When you get stuck
3
Users from other workspaces can't install the connection
The connection was created with 'Selected workspaces only', and that setting can't be changed.
FixCreate a new public connection with 'Any workspace' and switch your OAuth client to its credentials.
The Authorization URL field in the Configuration tab is blank
Notion fills it in only after the public connection is submitted for review.
FixBuild the authorize URL yourself from your client ID and redirect URI, or submit the connection in the portal.
Docs1· medium confidenceYou can't create a connection
You're probably not a workspace owner.
FixHave a workspace owner create it, or create a workspace you own.
Not confirmed
3
Does a public connection have to be submitted or approved before users outside your workspace can authorize it?
The docs say connections work without a Marketplace listing, but also that the authorization URL only fills in after submission for review. No developer reports from 2026 settle it.
ResolveCreate the connection, then authorize it from a second Notion account in a different workspace before submitting anything.
Are company name, website, privacy policy, terms and support email still required?
Older tutorials list these fields. The current public connections guide doesn't mention them.
ResolveCheck the live creation form in the Developer portal.
How long do access tokens last?
The docs describe refresh tokens but don't give an expiry.
ResolveLook at the token response, or test how long a token keeps working.
Sources
7
- 1AuthorizationNotion Developers · Official docs · not yet checked
- 2Public connectionsNotion Developers · Official docs · not yet checked
- 3List on the MarketplaceNotion Developers · Official docs · not yet checked
- 4Publishing integrations to Notion's Integration GalleryNotion Developers · Search results · not yet checked
- 5Notion OAuth 2.0 connector profileStackOne docs · Community · checked 27 Oct 2026
- 6Managed auth toolkitsComposio docs · Composio docs · checked 27 Oct 2026
- 7Getting startedNotion Developers · Official docs · checked 27 Oct 2026
Feedback
On the version researched 27 Oct 2026- worked
- 0
- waiting on review
- 0
- stuck
- 0
- wrong
- 0