Notion Integration

Overview

The Notion integration connects your agents to your Notion workspace, enabling them to search, read, create, and update pages, databases, blocks, and comments.

Setup

1. Go to notion.so/my-integrations and create a new internal integration
2. Copy the Integration Token (starts with ntn_)
3. Navigate to Settings → Connections in AgentPlatform
4. Click Connect next to Notion and paste your token
5. In Notion, share the pages/databases you want agents to access with your integration

Available Tools

Once connected, agents can use these Notion tools:

• notion_search — Search pages and databases
• notion_get_page — Retrieve a page with properties
• notion_create_page — Create a new page
• notion_update_page — Update page properties
• notion_query_database — Query a database with filters
• notion_get_database — Retrieve database schema
• notion_get_block — Retrieve a block
• notion_list_block_children — List child blocks
• notion_append_blocks — Append content blocks
• notion_create_comment — Add a comment
• notion_list_users — List workspace users

Webhooks

Notion does not natively push webhook events. To receive real-time updates, you can use a polling-to-webhook bridge or Notion's automation partners to forward events to:

POST https://your-domain.com/webhooks/notion/<instance_id>

When a webhook_secret is configured on the connector instance, requests must include an X-Notion-Signature header with an HMAC-SHA256 signature (sha256=<hex_digest>).

Permissions

Your Notion integration can only access pages and databases that have been explicitly shared with it. Make sure to share the relevant content with your integration in Notion's sharing settings.