diff --git a/connection-guides/iam/notion.mdx b/connection-guides/iam/notion.mdx new file mode 100644 index 00000000..46aa2b45 --- /dev/null +++ b/connection-guides/iam/notion.mdx @@ -0,0 +1,91 @@ +--- +title: "Notion" +description: "Follow these steps to connect Notion via the StackOne Hub successfully." +--- + +import IntegrationFooter from "/snippets/integration-footer.mdx"; + + + Ensure that your Notion account has **Workspace owner** or **Workspace admin** privileges. + + +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. + + + Log in to Notion + + + +## Create your Notion API Key + + + + Go to your Notion Profile Integrations page at https://www.notion.so/profile/integrations and click **New integration**. + + + Navigate to API Keys + + + + 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. + + + Create a new 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. + + + Copy your API Key + + + + 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. + + + Select API Key Scopes + + + + +## 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. + + + Enter Credentials + + + + +## Available data + +This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider: + \ No newline at end of file diff --git a/images/notion/iam_image1.png b/images/notion/iam_image1.png new file mode 100644 index 00000000..665a6bdd Binary files /dev/null and b/images/notion/iam_image1.png differ diff --git a/images/notion/iam_image2.png b/images/notion/iam_image2.png new file mode 100644 index 00000000..04298926 Binary files /dev/null and b/images/notion/iam_image2.png differ diff --git a/images/notion/iam_image3.png b/images/notion/iam_image3.png new file mode 100644 index 00000000..d426bca8 Binary files /dev/null and b/images/notion/iam_image3.png differ diff --git a/images/notion/iam_image4.png b/images/notion/iam_image4.png new file mode 100644 index 00000000..044548e6 Binary files /dev/null and b/images/notion/iam_image4.png differ diff --git a/images/notion/iam_image5.png b/images/notion/iam_image5.png new file mode 100644 index 00000000..f9dae724 Binary files /dev/null and b/images/notion/iam_image5.png differ diff --git a/images/notion/iam_image6.png b/images/notion/iam_image6.png new file mode 100644 index 00000000..2bff7de1 Binary files /dev/null and b/images/notion/iam_image6.png differ diff --git a/integrations.mdx b/integrations.mdx index caaaac4d..8de2a80e 100644 --- a/integrations.mdx +++ b/integrations.mdx @@ -139,6 +139,7 @@ import { IntegrationTile } from '/snippets/integration-tile.mdx'; +