> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image1.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=ebc8eb84042b3129e097ab8f57934136" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image2.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=cd0d2b9adce71d6be8921f5795364af9" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image3.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=ddee469b6da6431872754fb05d1c98d3" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image4.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=d50e49a28b4a5f81904914268e1e548d" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image5.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=1bed7abbfa463db64d07160ead42ce12" 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-docs-confluence-api-token-update/MGnlGQ2FDcYjia7O/images/notion/iam_image6.png?fit=max&auto=format&n=MGnlGQ2FDcYjia7O&q=85&s=221eee0c40ec9cfb2930dc4c99d31ca4" 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>