Skip to main content
You must be a workspace owner in Notion to create a public integration for OAuth 2.0.

Create a public connection

To enable OAuth 2.0, you need to create a public connection in Notion and retrieve the OAuth credentials.

1

Sign in to Notion

Sign in to your Notion account.

2

Create a new connection

Click the Create a new connection button.

  • Enter a Connection name (for example, StackOne OAuth).
  • Upload a Logo (required).
  • Select the Development workspace.
  • Add the following redirect URI: https://api.stackone.com/connect/oauth2/notion/callback
  • In Installable in, select Any workspace to allow installation in any workspace, or select Selected workspaces only to limit installation.
  • If you choose Selected workspaces only, the Selected workspaces dropdown appears below with the development workspace preselected, and you can add more workspaces from that dropdown.
  • Click Create.
  • In the confirmation popup, click Configure connection settings.
3

Configure capabilities

On the Edit connection page, configure the following capabilities.

  • Under Content capabilities and Comment capabilities, enable capabilities based on your needs.
  • Under User capabilities, select Read user information including email addresses (required for a successful connection).
  • Click Save.

Retrieve OAuth credentials

Copy the OAuth credentials from the Authorization section.

1

Copy OAuth credentials

Under the Authorization (OAuth) section, locate your OAuth credentials.

  • Copy the OAuth Client ID value.
  • Click Show next to OAuth Client Secret to reveal it.
  • Copy the OAuth Client Secret value.
  • Store both values securely for use later

Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for Notion:
1

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • Click + Connector Profile
  • Search for and select Notion
  • Select Type as OAuth 2.0
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for Notion.