Notion redirect URL for local development
For local development, set the redirect URL in Notion integration settings to http://localhost:3000/api/auth/callback/notion.
Better Auth · Authentication · all subjects
social sign-on/notion
10 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.
Notion OAuth credentials location
Notion OAuth credentials are obtained by creating a new integration in the Notion Developers Portal at https://www.notion.so/my-integrations.
Notion redirect URL for production
For production, set the redirect URL in Notion integration settings to your application domain, for example https://example.com/api/auth/callback/notion. If you change the base path of the auth routes, update the redirect URL accordingly.
Notion integration required capability for authentication
For user authentication with Notion, the integration must have the 'Read user information including email addresses' capability enabled.
Notion provider configuration with clientId and clientSecret
Configure Notion as a social provider by passing clientId and clientSecret to socialProviders.notion in the auth configuration. Example: socialProviders: { notion: { clientId: process.env.NOTION_CLIENT_ID as string, clientSecret: process.env.NOTION_CLIENT_SECRET as string } }
Sign in with Notion using signIn.social
Use the signIn.social function from the auth client with provider set to 'notion' to enable Notion sign-in. Example: authClient.signIn.social({ provider: 'notion' })
Notion public integrations
Public integrations in Notion can be installed by any Notion workspace and are recommended for most authentication use cases to allow users from different workspaces to sign in.
Notion internal integrations
Internal integrations in Notion are limited to your own workspace.
Request additional Notion scopes with linkSocial
If your application needs additional Notion capabilities after the user has already signed up, use the linkSocial method with the Notion provider. Notion automatically provides access based on integration capabilities.
Use Notion access token to interact with Notion API
After authentication, the access token can be used to interact with the Notion API to read and write pages, databases, and other content that the user has granted access to.