Notion Integration
API Key (Bearer)Connect your AI agent to Notion. Create pages, query databases, search content, and manage comments directly from conversations.
What your agent can do
With Notion credentials, your agent gets full access to your pages, databases, and workspace through the Notion API.
Page creation
Create new pages in any workspace or database, with full support for rich text, headings, and nested content.
Database queries
Query databases with filters, sorts, and pagination. Retrieve entries matching complex property conditions.
Content search
Search across your entire workspace by title or content, and locate pages, databases, and child blocks.
Block management
Append, update, and delete blocks within pages. Manage to-do lists, toggles, callouts, and embedded content.
Comment management
Add discussion comments to pages and blocks, retrieve comment threads, and keep conversations organized.
Prerequisites
- ✓A Notion account (Free, Plus, Business, or Enterprise)
- ✓An internal integration created at notion.so/my-integrations
- ✓Pages or databases shared with the integration (Notion requires explicit sharing)
- ✓A ClawTrust agent on any plan (Starter, Pro, or Enterprise)
Step-by-step setup
Create an internal integration in Notion and add the token to your agent.
Open Notion Integrations
Go to notion.so/my-integrations and sign in with your Notion account. This is the integration management page.
Create an internal integration
Click "New integration". Name it (e.g., "ClawTrust Agent"), select the workspace you want to connect, and choose the capabilities your agent needs (Read, Update, Insert content).
Copy the integration token
Copy the Internal Integration Secret (starts with ntn_). This is a Bearer token used for API authentication. You can regenerate it later if needed.
Add to ClawTrust
In your agent's dashboard, go to Credentials > Add Credential. Select "API Key (Bearer)", paste your token, and set allowed domains to *.notion.com and api.notion.so.
Credential details
Type
Header
Authorization: Bearer ntn_xxxAllowed domains
*.notion.com, api.notion.soFields
Internal Integration Token (single field)Example actions
Once connected, you can ask your agent to perform actions like these.
"Create a page in my Projects database"
Creates a new entry in the Projects database with default properties you specify.
"Search for all pages mentioning Q2 planning"
Searches the workspace and returns all pages and databases matching the query.
"Add a comment to the Sprint 12 page"
Finds the page by title and adds a discussion comment with your message.
"Query all tasks where Status is In Progress"
Filters the tasks database by the Status property and returns matching entries.
Ready to connect your agent to Notion?
Add your Integration Token and your agent starts managing pages and databases immediately.