Overview

Torii integrates with Notion and syncs the user list, status and licenses assigned to each user.

Workflow actions for provisioning and deprovisioning users are supported for Notion Enterprise users.

Note: Torii supports multiple Notion accounts

Prerequisites

The Notion integration can be connected with Read or Read and Take action permissions.

- For Read: a Notion API Key is required to read the users and license information.

- For Read and Take action: in addition to the Notion API Key, a SCIM Provisioning token is required to take provisioning and deprovisioning actions. This option is only available to the Notion Enterprise tier.

Generate a Notion API Key

1. From your Notion user go to Settings & Members

2. Select Connections
   
   

3. Scroll to the bottom and select Develop or manage integrations.
   (Alternatively, you can directly browse to Notion's My Integrations page)

   

4. Click on New Integration

5. Give the integration a name

6. Select a workspace to which you want to connect Torii
   Note: You can connect more then one integration, but you will be required to open New Integration per workspace

   

7. Make sure the Content Capabilities are checked
   Note: Minimum requirement Read Content

8. Under User Capabilities make sure the Read user information including email addresses is checked

9. Click Submit

   

10. Click Show and copy the Secrets (API key)

    

Generate a SCIM Provisioning token (optional)

Notion users who are on the Notion Enterprise plan can create a SCIM token to leverage workflow actions for user provisioning and deprovisioning.

1. Go to Notion -> Settings & members
2. Choose Identity and provisioning
   
3. Create a SCIM provisioning token
   
4. Copy the token

Connect the Notion integration to Torii

1. Go to the Integrations page

2. Connect to Notion

3. Paste the API key and optionally also the SCIM Provisioning token.

   

4. Once the application is synced, a green checkbox will appear at top left

5. If you wish to connect another workspace, find another Notion tile and click Connect another

   

Provisioning members

When creating a member, if they already have a Notion user account with the same email, they will be added to your workspace, and their name will remain the same.

If the user does not exist, a new Notion user will be created with the email and name you select and then added to your workspace.

Learn more on Notion help center.