Productivity / Enterprise
Notion OAuth
Public connections authorize a workspace and selected pages; the token response includes workspace and bot metadata.
Automated OAuth formProvider docs
What this workflow can do
- Build authorization URL
- Exchange authorization code
- Refresh token
- Verify access token
Before starting
- Client ID
- Client secret
- Redirect URI
- Provider-approved scopes
- PKCE only if your app requires it
- Callback code and state
Result handling
- Access token returns from exchange and can be verified in the result panel.
- Refresh token may return from exchange or refresh.
- Callback state is only used to validate the current handshake.
- Anonymous OAuth Hub workflows do not store client secrets, authorization codes, access tokens, or refresh tokens.
- 01PrepareEnter provider credentials, scopes, callback details, and PKCE values if required.
- 02AuthorizeBuild the authorization URL and open provider consent.
- 03ExchangePaste the returned code and state, then exchange them for tokens.
- 04VerifyTest the access token against the provider verification endpoint.
- 05Next stepsCopy tokens or metadata, then store them safely outside anonymous mode.
Returned from provider
Callback summary
Review returned callback values before exchanging.
- Authorization code
- Present
- Returned state
- Present
- Provider error
- —
- Error description
- —
- Error URI
- —
Troubleshooting
- The user must share pages or databases with the connection before API requests can access them.
- Notion refresh tokens rotate; retain the latest access and refresh token returned by each refresh.