Skip to main content
The Notion integration enables your agent to search for pages and retrieve page content from a connected Notion workspace.

​
Connecting Notion

​
Prerequisites

  • A Notion workspace with appropriate permissions
  • Project management permissions in PolyAI

​
Connection steps

  1. Go to the Integrations page in Agent Studio
  2. Find Notion and click Connect
  3. Select an environment (Sandbox, Pre-release, or Live)
  4. Click Connect new account
  5. Authenticate with your Notion workspace via OAuth
  6. You’ll be redirected back to PolyAI automatically

​
Available actions

ActionCategoryDescription
Search PagesKnowledge BaseSearch for pages across a connected Notion workspace
Get Page By IDKnowledge BaseRetrieve the content of a specific Notion page by its ID

​
Enabling actions

Reference Notion actions in your agent’s prompts — either enable all actions or select specific ones. See the Zoom integration for detailed examples of this pattern.

​
Example use case

Internal knowledge base lookup: 
You are a support agent. When you need to look up internal documentation,
search the Notion workspace for the relevant page and use its content
to answer the customer's question.

​
Troubleshooting

IssueSolution
Integration not appearingVerify the feature is enabled for your account and you have project management permissions
Agent can’t find pagesEnsure the Notion pages are shared with the connected integration
OAuth errorsEnsure pop-ups are not blocked, clear browser cache, or try a different browser

​
Support

For additional help, contact PolyAI support.