Configure Notion user provisioning

Note: You need at least one verified domain in your Notion Enterprise Plan account before setting up user provisioning.

1. Sign in to your Notion account at https://notion.so as a Workspace Owner. 
2. Click Settings & members.
3. Under WORKSPACE, go to Identity & ProvisioningSCIM configuration.

   Your available SCIM tokens are listed.

4. Do one of the following:
   • In the SCIM tokens table, click Copy next to a token.
   • Click Add Token in the right corner to generate a new token.

1. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

2. In the Admin console, go to Menu  AppsWeb and mobile apps.

3. Open the Notion application.
4. (Optional) To limit auto-provisioning to certain users, click User access and select the organizational units or groups that should have access to Notion. Alternately, if you are using groups (not organization units) to control auto-provisioning, you can do that in step 10 below. 
5. In the Auto-provisioning section, click Configure auto-provisioning.
6. In the App authorization step, in the Access token field, paste the SCIM token you copied from Notion.
7. Click Continue.
8. Verify that all mandatory Notion attributes (those marked with an *) are mapped to Google Cloud Directory attributes. If not, click the Down arrow  and map to the appropriate attribute.
9. Click Continue.
10.  (Optional) Restrict provisioning to specific groups:
    1. Enter all or part of a group name in the Search groups field.
       A list of available groups appears. Select a group to add it and open a new search field.
    2. If necessary, add more groups and choose a scope. 
    3. To remove any group you added, click  next to it.
11. Once you’re done, click Continue.
12. Choose how long deprovisioning actions should be delayed before taking effect. The amount of time before deprovisioning takes effect can be set to: within 24 hours or after one, 7, or 21 days. Select at least one of these options:

    • When an app is turned off for the user, soft delete their Notion account after [number of days].

      If a user is moved out of an organizational unit or group that has access to Notion, their Notion account is also soft deleted.

    • When a user is suspended on Google, soft delete their Notion account after [number of days].
    • When a user is deleted from Google, soft delete their Notion account after [number of days].

    Note: In the scenarios above, the user is removed from the selected workspace within the Notion account, but might still be present in other workspaces they were added to.

13. Click Finish.
14. In the Auto-provisioning section, click the activation slider.

    Note: The activation slider is disabled if Notion isn’t turned on for any users. Click User access and turn the app on to enable the slider.

15. In the confirmation dialog box, click Turn on.

Once provisioning is on, Google starts collecting usage information. You'll see the usage information in the Auto-provisioning section. There won't be any numbers next to the event names until you enable provisioning.

The following event names provide the usage information for the last 30 days:

• Users created
• Users suspended
• Users deleted
• Failures

For more information, see Monitor automated user provisioning.

You may want to restrict the scope of provisioning to members of groups you define. 

1. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

2. In the Admin console, go to Menu  AppsWeb and mobile apps.

3. Open the Notion application.
4. Click the Auto-provisioning section to open the settings page.
5. Under Provisioning scope, click Edit.
6. Enter all or part of a group name in the Search groups field. A list of available groups appears.
   1. Select a group to add it and open a new search field.
   2. If necessary, add more groups and choose a scope. 
   3. To remove any group you added, click  next to it.

   If a group has users from a secondary domain or from outside the organization, those users are not provisioned.

7. Once you’re done, click Update.

The next time you edit provisioning scope, the groups you added appear in the Provisioning scope window. If you turned on the Notion application for a set of organizational units, the provisioning scope is restricted to those users in the added groups who are also members of those organizations.

To disable auto-provisioning for the Notion application without losing all the configuration information:

1. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

2. In the Admin console, go to Menu  AppsWeb and mobile apps.

3. Open the Notion application.
4. Do one of the following:
   • In the Auto-provisioning section, click the activation slider.
   • Click the Auto-provisioning section to open the settings page, then click StatusTurn off.
5. In the confirmation dialog box, click Turn off. 

To define how long deprovisioning actions should be delayed before taking effect:

1. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

2. In the Admin console, go to Menu  AppsWeb and mobile apps.

3. Open the Notion application.
4. Click the Auto-provisioning section to open the settings page.
5. Under Deprovisioning, click Edit.
6. Choose how long deprovisioning actions should be delayed before taking effect. The amount of time before deprovisioning takes effect can be set to: within 24 hours or after one, 7, or 21 days. Select at least one of these options:

   • When an app is turned off for the user, soft delete their Notion account after [number of days].

   • When a user is suspended on Google, soft delete their Notion account after [number of days].
   • When a user is deleted from Google, suspend their account, soft delete their Notion account after [number of days].

   Note: In the scenarios above, the user is removed from the selected workspace within the Notion account, but might still be present in other workspaces they were added to.

7. Click Update to save your edited deprovisioning configuration.

To disable auto-provisioning for the Notion application and remove all the configuration information:

1. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

2. In the Admin console, go to Menu  AppsWeb and mobile apps.

3. Open the Notion application.
4. Click the Auto-provisioning section to open the settings page.
5. Under Delete configuration, click Delete.
6. Click Delete to both deactivate auto-provisioning and remove all the configuration information.
   Existing users on Notion will not be deprovisioned.

If the admin password for Notion has changed, automatic provisioning will stop working. In this case, the original authorization is revoked by Notion, and you must reauthorize automatic provisioning.

1. Follow the steps in Get the API token for the Notion application, above, to get a new access token from Notion.
2. Sign in to your Google Admin console.

   Sign in using your administrator account (does not end in @gmail.com).

3. In the Admin console, go to Menu  AppsWeb and mobile apps.

4. Click the Notion application.
5. Click the Auto-provisioning section to open the settings page.
6. Under App authorization, click Reauthorize.
7. Enter your Notion access token, then click Re-authorize.

After reauthorization completes, you're returned to the Auto-provisioning settings page in the Admin console.

Note: Your third-party application might revoke authorization for reasons other than the admin password changing. These reasons can include account inactivity, for example. Check with the documentation for the third-party application for scenarios in which authorization can be revoked.