║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║

---

title: Add Notion as a social connection description: Learn how to allow users to sign up and sign in to your Clerk app with their Notion account using OAuth.

<TutorialHero beforeYouStart={[ { title: "A Clerk app is required.", link: "/docs/getting-started/quickstart/setup-clerk", icon: "clerk", }, { title: "A Notion Developer account is required.", link: "https://developers.notion.com/", icon: "user-circle", } ]} />

Enabling OAuth with Notion allows your users to sign up and sign in to your Clerk app with their Notion account.

Configure for your development instance

For development instances, Clerk uses preconfigured shared OAuth credentials and redirect URIs—no other configuration is needed.

1. In the Clerk Dashboard, navigate to the SSO connections page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select Notion.
4. Select Add connection.

Configure for your production instance

For production instances, you must provide custom credentials.

To make the setup process easier, it's recommended to keep two browser tabs open: one for the Clerk Dashboard and one for your Notion Developer page.

<Steps> ### Enable Notion as a social connection

1. In the Clerk Dashboard, navigate to the SSO connections page.
2. Select Add connection and select For all users.
3. In the Choose provider dropdown, select Notion.
4. Ensure that both Enable for sign-up and sign-in and Use custom credentials are toggled on.
5. Save the Authorization URL somewhere secure. Keep this modal and page open.

Create a Notion app

1. In the top-right of the Notion Developer home page, select View my integrations. You'll be redirected to the Integrations page.
2. Select New integration.
3. Fill out the necessary information. In the Type dropdown, select Public. Under Authorization URL, paste the Authorization URL value you saved from the Clerk Dashboard and then select it.
4. Select Save. The Integration successfully created modal will open. Select Configure integration settings. You'll be redirected to the app's Configuration page.
5. Save the OAuth Client ID and OAuth Client Secret somewhere secure.

Set the Client ID and Client Secret in the Clerk Dashboard

<Include src="_partials/authentication/social-connections/set-client-id-secret" />

Test your connection

<Include src="_partials/authentication/social-connections/test-your-connection" /> </Steps>

║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║
║