Notion

A Notion integration connects a Notion public integration to Mobius through OAuth. Assistants can search the workspace, get, create, and update pages, query databases, append blocks, and create comments. Mobius also records Notion change events.

Use Notion when an assistant's output should land in a workspace knowledge base or when it needs to read structured database entries before taking action.

Capability map

Connect Notion

Mobius supplies the OAuth callback. If Continue with Notion is unavailable, Notion is not enabled for your Mobius organization; ask your organization administrator or Mobius support to check it. After the consent screen, Mobius stores the connection for the organization.

Share each Notion page or database with the connection during the Notion authorization flow. Mobius can only read and write objects the authorized connection can access.

Notion is a team-managed workspace connection. An organization administrator connects or reconnects it. Under Assistant access, grant this exact Notion workspace to the assistants that need it, then choose the whole team or named people as its Mobius result audience. This grant does not expand the pages and databases shared with the Notion integration.

Receive Notion events

Mobius receives Notion events through the provider webhook endpoint. Notion does not expose subscription creation through the OAuth token, so you create the subscription in Notion and paste the Mobius URL.

1. In Mobius, connect Notion with OAuth.
2. Copy the Webhook endpoints URL from the Notion integration page.
3. In the Notion developer portal, open your connection and click Webhooks.
4. Create a subscription with the Mobius URL and select the event types you need.
5. When Notion sends the verification callback, Mobius stores the verification token for signature validation and shows it on the integration page.
6. In Notion, click Verify, paste the verification token from Mobius, and confirm the subscription.

Your Notion subscription now delivers signed callbacks to Mobius. Aggregated events such as page.content_updated can take up to a minute to arrive. Treat the verification token as a signing secret. If it leaks, delete and recreate the Notion webhook subscription.

Actions

notion.block.append
notion.comment.create
notion.database.query
notion.page.create
notion.page.get
notion.page.update
notion.search

Use notion.search with a title query, or omit the query to browse everything shared with the connection. Its optional filter accepts page or data_source; leave the filter out to return both. Use notion.database.query when an assistant needs a filtered set of records.

notion.block.append, notion.comment.create, notion.page.create, and notion.page.update change the workspace without an automatic Mobius confirmation. The exact Notion connection and grant are still rechecked before dispatch.

Events

Mobius emits these Notion events:

notion.comment.created
notion.comment.deleted
notion.comment.updated
notion.data_source.content_updated
notion.data_source.created
notion.data_source.deleted
notion.data_source.moved
notion.data_source.schema_updated
notion.data_source.undeleted
notion.database.content_updated
notion.database.created
notion.database.deleted
notion.database.moved
notion.database.schema_updated
notion.database.undeleted
notion.page.content_updated
notion.page.created
notion.page.deleted
notion.page.locked
notion.page.moved
notion.page.properties_updated
notion.page.undeleted
notion.page.unlocked

Notion webhook payloads are lightweight signals. Use the entity ID from the event payload with notion.page.get, notion.database.query, or another Notion action when you need the latest content.

Next

• Review account access in Connect accounts.
• Read event names in the event catalog.
• Grant Notion actions to an assistant from actions.
• Save generated docs as artifacts.