> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-claude-issue-384-20260409-1436.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Follow these steps to connect Notion via the StackOne Hub successfully.

<Warning>
  Ensure that your Notion account has **Workspace owner** or **Workspace admin** privileges.
</Warning>

If you've been directed to StackOne to integrate with Notion, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Log in to Notion

Log in to your Notion account.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Log in to Notion" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image1.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=66d1a3a3611fa173d45008703d7ab7c5" width="824" height="1212" data-path="images/notion/iam_image1.png" />
</Frame>

## Create your Notion API Key

<Steps>
  <Step title="Navigate to Integrations">
    Go to your Notion Profile Integrations page at [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations) and click **New integration**.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Navigate to API Keys" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image2.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=1091847df8a890ff77ab6c24955f4714" width="2112" height="766" data-path="images/notion/iam_image2.png" />
    </Frame>
  </Step>

  <Step title="Enter Integration Details">
    Enter/select the following fields:

    * **Integration Name**: A name for your integration
    * **Associated workspace**: The Notion Workspace that this integration will have access to
    * **Type**: Select *Internal*

    Click **Save** to continue.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create a new API Key" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image3.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=62cebdcf09f6174eaae68fbda387ecbe" width="1814" height="1082" data-path="images/notion/iam_image3.png" />
    </Frame>
  </Step>

  <Step title="Copy your API Key">
    A popup will appear displaying that the integration has been created successfully. Click **Configure integration settings** to continue.

    Your **API Key** will be available to copy under *Internal Integration Secret*. **Copy** this value and store it safely to be used in a later step.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy your API Key" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image4.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=10aabf0da06ca920b772acbdc0bb3995" width="1802" height="668" data-path="images/notion/iam_image4.png" />
    </Frame>
  </Step>

  <Step title="Select API Key Capabilities">
    Under *Capabilities* > *User Capabilities* ensure that "Read user information including email addresses" is selected. This is the only capability required for this integration.

    Click **Save** to continue.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select API Key Scopes" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image5.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=98e4f5a4307fa51801d1356faf683312" width="1808" height="1272" data-path="images/notion/iam_image5.png" />
    </Frame>
  </Step>
</Steps>

## Create your Notion SCIM Token (optional)

A SCIM Token is needed for retrieving User Roles via this integration, but is only available for Notion Enterprise customers with SCIM Provisioning enabled.

For more information on this and obtaining a SCIM Token, please refer to the [Notion SCIM Provisioning documentation](https://www.notion.com/help/provision-users-and-groups-with-scim).

## Connecting with StackOne

Upon reaching the Link Account page, enter the credential(s) from the previous steps:

* **API Key**
* **SCIM Token** (optional)

Proceed by clicking the Connect button.

<Frame>
  <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-claude-issue-384-20260409-1436/FzpNSkEq1zal2KzY/images/notion/iam_image6.png?fit=max&auto=format&n=FzpNSkEq1zal2KzY&q=85&s=989a1ff3327302cbe575634934e38824" width="876" height="1256" data-path="images/notion/iam_image6.png" />
</Frame>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>