> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Notion in StackOne. One-time admin setup required before your users can link Notion accounts via Hub.

<Warning>You must be a workspace owner in Notion to create a public integration for OAuth 2.0.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a public connection</h2>

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

  <Steps>
    <Step title="Sign in to Notion">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://www.notion.so/login" target="_blank" rel="noopener noreferrer">Notion account</a>.</p>

        <ul>
          <li>Navigate to <a href="https://www.notion.so/profile/integrations/oauth" target="_blank" rel="noopener noreferrer"><strong>Public Integrations</strong></a>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a new connection">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>Create a new connection</strong> button.</p>

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

    <Step title="Configure capabilities">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Edit connection</strong> page, configure the following capabilities.</p>

        <ul>
          <li>Under <strong>Content capabilities</strong> and <strong>Comment capabilities</strong>, enable capabilities based on your needs.</li>
          <li>Under <strong>User capabilities</strong>, select <strong>Read user information including email addresses</strong> (required for a successful connection).</li>
          <li>Click <strong>Save</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Retrieve OAuth credentials</h2>

  <p>Copy the OAuth credentials from the Authorization section.</p>

  <Steps>
    <Step title="Copy OAuth credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under the <strong>Authorization (OAuth)</strong> section, locate your OAuth credentials.</p>

        <ul>
          <li>Copy the <strong>OAuth Client ID</strong> value.</li>
          <li>Click <strong>Show</strong> next to <strong>OAuth Client Secret</strong> to reveal it.</li>
          <li>Copy the <strong>OAuth Client Secret</strong> value.</li>
          <li>Store both values securely for use later</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Notion</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Notion</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Notion</strong>.