> ## Documentation Index
> Fetch the complete documentation index at: https://hyperfx.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Set up and use the Notion integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect Notion

1. Go to Settings → Apps in Hyper
2. Select Notion → Connect New
3. Complete OAuth and select the pages/databases to share with Hyper

## Common capabilities

* Create and update pages and databases
* Organize workspaces and maintain documentation
* Search and retrieve structured knowledge

## Use in Chat

Enable Notion in the tool selector. Ask your agent to create pages, update databases, or search your workspace.

## Use in Agents

Add Notion to an agent's toolkits and select the connection. Require approval for write operations if desired.

## Use in Flows

Automate documentation updates, database management, and knowledge base workflows using Notion action nodes.

## Troubleshooting

* Page not found: verify the integration has access to the target page or database
* Permission errors: re-authorize and ensure the correct pages are shared

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                | Description                                                   |
| --------------------- | ------------------------------------------------------------- |
| Append Block Children | Append new child blocks to a Notion block                     |
| Create Database       | Create a new database in Notion                               |
| Create Page           | Create a new page in Notion                                   |
| Get Block Children    | Get children blocks of a Notion block                         |
| Get Comments          | Get comments on a Notion block                                |
| Get Database          | Get a Notion database by ID                                   |
| Get Page              | Get a Notion page by ID                                       |
| Query Database        | Query pages from a Notion database with filtering and sorting |
| Search                | Search for pages and databases in Notion workspace            |
| Update Page           | Update an existing page in Notion                             |