> ## 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.

# Connect Notion with Installation Access Token – StackOne Hub

> Link a Notion account in the StackOne Hub using Installation Access Token. End-user guide to authorize the integration and start using Notion actions.

<Warning>You must be a workspace owner in Notion to create an integration and generate an access token.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a Notion integration</h2>

  <p>To connect Notion with StackOne, you need to create an internal integration and retrieve the access token.</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" target="_blank" rel="noopener noreferrer"><strong>My 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 to create a new internal connection.</p>

        <ul>
          <li>Enter a <strong>Connection name</strong> (for example, `StackOne`).</li>
          <li>Upload an icon if needed (optional).</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>, use the <strong>Selected workspaces</strong> dropdown shown below to keep the default development workspace or add more workspaces.</li>
          <li>Click <strong>Create</strong>.</li>
          <li>In the confirmation popup, click <strong>Configure integration settings</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure capabilities and save">
      <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>If you see "Your connection doesn't have access to any pages yet", navigate to the <strong>Content access</strong> tab. A pop-up will appear — click the <strong>Edit access</strong> button to select the required pages.</li>
          <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>

    <Step title="Copy the access token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>Configuration</strong> tab, locate the <strong>Installation access token</strong> section.</p>

        <ul>
          <li>Click <strong>Show</strong> to reveal the token.</li>
          <li>Click <strong>Copy</strong> to copy the token.</li>
          <li>Store it securely for use later</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Linking the Account from the Hub

<Steps>
  <Step title="Navigate to the Hub">
    Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
  </Step>

  <Step title="Fill out the fields">
    Fill out the following fields using details from your provider:

    <ul>
      <li><strong>Installation Access Token</strong></li>
    </ul>
  </Step>

  <Step title="Connect">
    <ul>
      <li>Click <strong>Connect</strong></li>
      <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
      <li>Once authorization is successful, you will see a confirmation popup</li>
    </ul>
  </Step>
</Steps>

If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.

## Next Steps

<Columns cols={2}>
  <Card title="Webhooks setup" href="/connectors/notion/guides/webhook-setup">
    <p className="connector-page-auth-description" style={{ fontSize: '14px', marginTop: 0, marginBottom: 0 }}>
      Configure receiving Events for Notion into StackOne.
    </p>
  </Card>
</Columns>
