Collaboration

Notion

Put your Notion knowledge base, runbooks, and documentation to work - Dex searches, reads, and maintains pages in plain language.

Dex connects to a Notion workspace so it can find, read, create, and maintain the pages in a customer knowledge base - runbooks, how-tos, and documentation. Admins can search pages, read them as markdown, create and update documentation, inspect the property schema, and read comments. Employees get read-first self-service: Dex looks up the answer in their organization's knowledge base and cites the page it came from. Built as an MSP global app: one shared workspace token, with each customer confined to its own Notion data source (one data source per customer) so no tenant can see another's pages. A scheduled importer also syncs each data source into a Dex dataset for knowledge search.

Start with $100 free →See Dex Live

What Dex does with Notion

Dex handles both admin workflows and employee self-service — all policy-guardrailed and audit-logged.

For admins (Dex Pro)

Search the customer knowledge base by title, status, or recently-edited date
Read a page as markdown in one call, or read its properties, parent, and timestamps
Create new pages with properties and body content, authored as markdown
Update page properties, icon, and cover, and trash or restore a page (recoverable from Notion's trash)
Append blocks or replace a page's body content, with reversible markdown edits
Inspect the property schema so writes use the customer's real column names
Read unresolved comments on a page
Change the knowledge base schema - title, description, or properties - with approval
Deploy as an MSP global app - one workspace token, each customer scoped to its own Notion data source

For employees (self-service)

Ask a how-to or runbook question and get the answer from your organization's knowledge base
Get the exact steps, commands, and links quoted from the source page, with the page cited
Hear when a page looks stale so you know to double-check it
Add a note to a page you are already working with, when you ask for it

Just ask Dex

Your team types a request in plain language. Dex investigates, plans, and executes — with the right guardrails.

Admin prompts

>Find the "VPN client setup" page and show me its current content
>Which knowledge base pages were edited since the start of last month?
>Create a Draft page called "Onboarding checklist" with a Prerequisites heading
>Update the status of the onboarding runbook to Published
>Append a "Reviewed 2026-08" callout to the backup runbook

Employee prompts

>How do I set up the VPN on a company laptop?
>What's our process for onboarding a new hire?
>Where's the runbook for restoring a backup?

Policy actions

Every action Dex can take on Notion is declared, scoped, and guardrailed. Admins control which apply, who approves them, and whether they're limited to self-service.

Action	What it does	Guardrails
`notion_search_pages`	Search the organization's Notion knowledge base for pages	—
`notion_read_schema`	Read the knowledge base title, description, and property schema	—
`notion_read_page`	Read a Notion page's properties and its content as markdown	—
`notion_read_page_content`	Read the blocks that make up a Notion page	—
`notion_read_comments`	Read unresolved comments on a Notion page	—
`notion_create_page`	Create a new page in the organization's knowledge base	—
`notion_update_page`	Update a Notion page's properties, icon, or cover (also trashes and restores pages)	—
`notion_append_content`	Append blocks to an existing Notion page	—
`notion_replace_page_content`	Insert or replace a Notion page's content as markdown	—
`notion_update_schema`	Change the knowledge base schema - affects every existing page	approval

How to configure Notion

Onboarding takes minutes. Dex validates your credentials before saving them.

Setup steps

1
In Notion, open Settings > Connections > Develop or manage integrations and create (or pick) an internal connection.
2
Copy the Internal Integration Secret from the connection's Configuration tab.
3
In the developer portal, enable the connection's capabilities: Read content, Update content, Insert content, and Read comments.
4
Share the customer's database with the connection: open it in Notion, click ••• > Connections, and add the Dex connection - access is inherited by child pages.
5
Get the customer's data source id: open the database, choose ••• > Copy link, take the 32-character id from the URL, call GET /v1/databases/{database_id}, and use the id from its data_sources array.
6
In Dex, enable the Notion integration and paste the api_token and data_source_id. Dex validates the token and confirms access to the data source before saving. For the MSP master org, leave data_source_id blank for an unscoped connection.

Credentials required

api_token: Notion Internal Integration Secret (ntn_..., older tokens secret_...) from the connection's Configuration tab
data_source_id: The customer's Notion data source id (32 hex characters, dashes optional) - the per-tenant isolation key; leave blank only for the MSP master's own unscoped connection

Requirements

•A Notion workspace with an internal connection and its Internal Integration Secret
•The connection's capabilities enabled (Read/Update/Insert content, Read comments) to match the actions you use
•The customer's database shared with the Dex connection, or every call returns 404 object_not_found
•A data source id per customer (not the database id) - call GET /v1/databases/{database_id} and use the id from its data_sources array
•For MSPs, the integration deploys as a global app with one workspace token and per-customer scoping by data source

Related integrations

See Dex run Notion

Book a 30-minute walkthrough with our team and see how autonomous IT works in your environment — or get started for free.

Start with $100 free →See Dex Live Browse all integrations →