Notion
Help teams and customers find answers buried in Notion pages and databases without hunting through the workspace manually.
6 min read
Updated February 2026
Overview
Your team spent weeks building a beautifully organized Notion workspace — product specs, HR policies, runbooks, project trackers. But when someone asks “What's our refund policy?” or “When is Project Alpha due?” in chat, nobody wants to dig through nested pages to find the answer.
The Notion integration lets your AI agent search across pages, query databases, and retrieve specific page content on demand. Your chatbot becomes the fastest way to get information out of Notion.
When to Enable This
- Your company wiki, SOPs, or product docs live in Notion and employees ask about them frequently
- You track projects, inventories, or customer lists in Notion databases and want chat-based lookups
- Customer-facing agents should pull answers from internal Notion docs to respond accurately
Available Actions
| Action | Description |
|---|---|
| Search Pages | Full-text search across all shared Notion pages |
| Query Database | Filter and retrieve records from a Notion database |
| Get Page | Fetch the full content of a specific Notion page by ID |
Prerequisites
Before connecting Notion, make sure you have:
- A Notion workspace (free or paid)
- Admin access to create internal integrations
- The pages and databases you want to query shared with the integration
Setup Instructions
Step 1: Create an Internal Integration
- Go to notion.so/my-integrations
- Click New integration
- Name it “ChatSpark” and select your workspace
- Under Capabilities, enable Read content
- Click Submit and copy the Internal Integration Token
Step 2: Share Pages with the Integration
- Open each Notion page or database you want the AI to access
- Click the ••• menu → Add connections
- Search for “ChatSpark” and confirm
Step 3: Enable in ChatSpark
- In ChatSpark, go to AI Actions
- Find Notion in the Library and click Enable
- Select the chatbot(s) that should have access
- Paste your Internal Integration Token
- Click Save
Configuration Fields
| Field | Description | Example |
|---|---|---|
| API Key | Your Notion internal integration token | ntn_xxxxxxxxxxxx... |
Testing Your Integration
After setup, open your chatbot widget and try these realistic queries:
- Ask: “What does our refund policy say about digital products?”
- The AI should search your Notion pages and return the relevant content
More test phrases:
- “Look up the Project Alpha timeline in our project tracker”
- “What are the steps in our employee onboarding checklist?”
- “Find the product spec for the v2.0 release”
Troubleshooting
No results returned
Make sure the relevant pages are shared with your integration. Notion integrations only see pages explicitly connected to them — workspace-wide access is not automatic.
Database query returns empty
Verify that the database has been shared with the integration and that it contains records matching the query. Check that property names match what the AI is searching for.
Token invalid
Notion integration tokens don't expire, but they can be revoked. If authentication fails, check that the integration is still active at notion.so/my-integrations.