- See the people in a Notion workspace
- See permission groups and who is in each group
- Let people request to join a group, and remove them when access expires
- Delegate approvals to the right owners
Supported resources
Requirements
Before you begin, you must:- Be an Opal Admin
- Be a Notion organization owner. Group sync needs the Enterprise plan
- Be able to create an organization-level admin API token
Configuration steps
1. Create an organization token
- In Notion, open the workspace switcher and select Manage organization.
- Go to General, then Manage organization-level admin API tokens.
- Select Create connection. Name it, for example
Opal. - Give the connection these scopes:
- Select Create token and copy the token. Store it where your team keeps secrets.
permission-group scopes appear only for eligible Enterprise organizations. If they are missing, contact your Notion representative.
The same token is also used to list workspace members. People without an email address are skipped.
2. Create a Notion app in Opal
In Opal, go to Inventory > + App, then select Notion. Fill in the following fields and create the app.
Opal reads the workspace from the token. You do not enter a workspace ID.
Saving the app again with the same token restores the existing app. A different token is a different app, even for the same workspace.
3. Confirm the sync
After you create the app, Opal syncs members onto the Accounts tab and permission groups onto the Groups tab. Turn on requests for the groups people should be able to ask for. A request adds the person as a Member. When the grant is revoked or expires, Opal removes them from the group.Groups
- Already a member: Opal leaves them as they are, including group Owners. It does not change their role.
- Not a member: Opal adds them as a Member. Restricted members can be added as members. Notion does not allow guests in a permission group.
- Remove: Opal removes them from the group. This includes group Owners. Opal cannot grant the Owner role.
- SCIM: If your identity provider manages the group’s membership, Notion rejects the change. Update that group in the identity provider.
- Nested groups: Opal syncs direct user members only. Membership that comes from a group inside a group is not listed.
What Opal does not manage
- Inviting, creating, or removing Notion users
- Guests
- The Owner role inside a group
- Groups whose membership is managed by SCIM
- Nested groups
- Access to pages, databases, and teamspaces
- Audit tickets and ticket propagation. Those stay on the existing Notion ticketing integration.