Connect your Notion workspace to Viio to see who actually uses seats, spot idle licences, and keep spend in line with real-world need.
Capabilities
Capability | What Viio pulls from Notion |
✅ Users | Name, email, workspace role and status |
Prerequisites
You must be a Notion workspace admin to create the internal integration token.
Setup
Go to Viio → Integrations and choose Notion.
In a new tab, generate an internal integration token:
Open Settings & Members → Integrations → Develop your own integrations in Notion.
Click + New integration and give it a name.
Select the workspace and press Submit.
Reveal the Internal Integration Token and copy it.
Back in Viio, click Connect Notion and paste the token.
Review the permission summary and hit Allow. Viio starts the first sync (up to 15 minutes).
Need to disconnect?
In Viio, open Installed apps → Notion → Remove.
You can also revoke the token in Notion under Settings & Members → Integrations.
Troubleshooting & FAQ
Symptom | Quick fix |
“Token invalid” error | Check the token wasn’t regenerated or revoked. Paste the latest token in Viio and reconnect. |
No users appear | Make sure the admin who created the token still belongs to the workspace and has access to All Members. |
Data stopped updating | Tokens can expire after permission changes. Recreate the token and reconnect Notion. |
Technical details
Permissions requested – Viio inherits the scopes of the token creator; we only use read-only calls to pull user and licence data. help.viio.io
Primary endpoint called –
GET /v1/users(list workspace members).Data refresh runs daily; trigger an on-demand sync from Viio anytime.
Additional resources
Notion API docs: https://developers.notion.com