Integrations

Notion

A Notion integration connects a Notion public connection to Mobius through OAuth so agents can search, read, create, and update Notion pages, databases, blocks, and comments, and so Mobius records Notion change events.

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

Capability map

Capability	Value
Provider ID	`notion`
Auth kind	`oauth2_user`
Connect flow	Notion OAuth public connection
Actions	Yes
Events	Yes
Webhook delivery	Yes
Event samples	No
Live status	No

Connect Notion

Surface	Support
App	Open Library > Integrations, choose Notion, and click Continue with Notion.
CLI	The `mobius` CLI does not connect Notion integrations yet. Use the app or API.
API	Call `POST /v1/integrations/providers/notion/connect` with `{}`, then send the browser to the returned `redirect_url`.

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.

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.

In Mobius, connect Notion with OAuth.
Copy the Webhook endpoints URL from the Notion integration page.
In the Notion developer portal, open your connection and click Webhooks.
Create a subscription with the Mobius URL and select the event types your you need.
When Notion sends the verification callback, Mobius stores the verification token for signature validation and shows it on the integration page.
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 to resolve page and database IDs before writing. Use notion.database.query when an agent needs a filtered set of records.

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.

Read event names in the event catalog.
Grant Notion actions to an agent from actions.
Save generated docs as artifacts.