ConfigView pulls Notion data through a single workspace integration token that you create in your Notion workspace. The token only sees pages and databases the integration has been explicitly added to — so the inventory reflects what the integration is shared with, not your full workspace. You will end up with 1 secret in ConfigView (Documentation Index
Fetch the complete documentation index at: https://support.configview.com/llms.txt
Use this file to discover all available pages before exploring further.
NOTION_TOKEN) when setup is complete.
Important visibility caveat. Notion’s workspace API does not expose a complete user list, a complete page list, or “all installed integrations” on Team or Business plans. ConfigView sees exactly what your integration has been invited to. To inventory every integration installed in the workspace, or to ingest the full audit log, you need a Notion Enterprise plan and the Audit Log API — that is a separate setup and is not covered here yet.
Step 1: Create the Notion integration
- Sign in to your Notion workspace as a Workspace Owner at https://www.notion.so
- Open https://www.notion.so/profile/integrations (or Settings → My connections → Develop or manage integrations)
- Click + New integration
- Name:
ConfigView - Associated workspace: pick the workspace ConfigView should inventory
- Type: Internal
- Capabilities: ConfigView only reads data. Enable the read capabilities:
- Read content
- Read comments
- Read user information including email addresses
- Click Save
- On the next screen, copy the Internal Integration Secret (starts with
ntn_orsecret_). You will not be able to see it again — store it somewhere safe.
Step 2: Share pages and databases with the integration
The integration starts with zero access. You must explicitly share each top-level page or database you want ConfigView to see — sub-pages inherit access from their parent. The fastest way to inventory broadly:- Open the top-level workspace page (or each top-level page you want inventoried)
- Click the
...menu in the top-right → Connections → Add connections - Search for ConfigView and click to add it
- Repeat for each top-level page or database
Tip: If you want ConfigView to see everything, share a single top-level page that contains (or is the ancestor of) all the content you care about. Nested pages and databases inherit access automatically.
Step 3: Add the secret to ConfigView
- Go to your ConfigView dashboard:
https://{companyname}.configview.com/admin/secret/ - Click Add Secret
- Secret name:
NOTION_TOKEN - Secret value: Paste the Internal Integration Secret from Step 1
- Click Save
Step 4: Enable the Notion scripts in ConfigView
- Go to:
https://{companyname}.configview.com/admin/cron/ - You should see notion in the list of available apps
- Select the scripts you want to run:
| Script | Notes |
|---|---|
| Bot Token Introspect | Validates the token and records the workspace name/bot owner. Safe to always enable. |
| Users | Workspace members + bots the integration can see. Person users include email; bots include owner info. |
| Databases | Every database shared with the integration. |
| Database Rows | Rows inside each database. Depends on Databases. |
| Pages | Every page shared with the integration. |
| Blocks | Top-level blocks for each page (paragraphs, headings, lists, etc.). Depends on Pages. Top-level only — does not recurse into nested children. |
| Comments | Comments on each page. Depends on Pages. |
| Search Index | A flat catalog of every object (page + database) visible to search. Useful for discovery and cross-checking what the integration can see. |
- Click Save
Note: Database Rows depends on Databases; Blocks and Comments depend on Pages. ConfigView wires these dependencies automatically — parent scripts always run first.
Step 5: Verify
- Go to:
https://{companyname}.configview.com/admin/status/ - Run the Notion health check
- The check should pass with the workspace name from your introspect
401 Unauthorized— Token was revoked or copied incorrectly. Re-issue from Step 1 and update theNOTION_TOKENsecret.Usersreturns zero or only bots — Notion’s/usersendpoint requires the Read user information capability. Edit the integration (Step 1, item 7) to enable that capability and retry.DatabasesorPagesreturns zero — The integration has not been added as a connection on any page yet. Repeat Step 2.
Data Tables
Once the scripts run, the corresponding tables are created in your database. All tables include arun_at column for historical tracking.
| Table | Source | Key Columns |
|---|---|---|
notion_introspect | GET /v1/users/me | bot_id, bot_name, workspace_name, owner_type, capabilities_json |
notion_users | GET /v1/users | user_id, type (person/bot), name, email, bot_owner_type |
notion_databases | POST /v1/search (filter=database) | database_id, title, parent_type, parent_id, archived, last_edited_time, properties_json |
notion_database_rows | POST /v1/databases/{id}/query | database_id, page_id, archived, last_edited_time, properties_json |
notion_pages | POST /v1/search (filter=page) | page_id, title, parent_type, parent_id, archived, public_url, last_edited_time |
notion_blocks | GET /v1/blocks/{id}/children | block_id, page_id, type, plain_text, has_children |
notion_comments | GET /v1/comments | comment_id, page_id, discussion_id, created_by_user_id, plain_text |
notion_search | POST /v1/search (no filter) | object_id, object_type, title, url, last_edited_time |
What you can’t ingest with this setup
Two questions ConfigView cannot answer with a workspace integration token alone:- “What integrations are installed in our Notion workspace?” Notion’s public API does not expose a workspace-wide integrations list. The only supported path is the Audit Log API on Notion Enterprise, scanning for
integration.addandintegration.removeevents. - “List every user in our Notion workspace.” The
/usersendpoint returns workspace people and visible bots, but on Team/Business plans some users (especially guests) may not appear unless the integration has been added to content they touch. For a complete directory, use Notion SCIM on Enterprise.