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

# Notion

> Connect Notion to your workflows: 32 operations across 9 categories.

The Notion node adds Notion operations to your workflows. Add it on the canvas or ask the AI builder for it by name, then pick an operation and fill in its fields.

Notion also includes 5 trigger operations (marked in the tables below) that can start a workflow when something happens in Notion.

<Note>
  You can wire the Notion node into an AI agent as a tool provider: the agent calls the operations you allow. See [Agent tools](/agents/tools).
</Note>

## Credentials

Connect Notion under **Credentials** in the node settings. See [Connecting credentials](/credentials/connecting) for the general flow.

### OAuth

Sign in with your Notion account when prompted; no keys to copy.

### Integration token

Enter the values manually when creating the credential.

[Get your credentials here](https://www.notion.so/my-integrations).

## Operations

### Block

| Operation                    | ID                         | Description                                  | Trigger |
| ---------------------------- | -------------------------- | -------------------------------------------- | ------- |
| **Append Children to Block** | `append_children_to_block` | Append new children blocks to a parent block |         |
| **Delete Notion Block**      | `delete_notion_block`      | Delete (archive) a block                     |         |
| **Fetch Block Children**     | `fetch_block_children`     | Retrieve a block's children                  |         |
| **Fetch Notion Block**       | `fetch_notion_block`       | Retrieve a block                             |         |
| **Update Block Content**     | `update_block_content`     | Update a block's content                     |         |

### Comment

| Operation               | ID                    | Description                                                    | Trigger |
| ----------------------- | --------------------- | -------------------------------------------------------------- | ------- |
| **Create Page Comment** | `create_page_comment` | Create a comment on a page or in an existing discussion thread |         |
| **Delete Page Comment** | `delete_page_comment` | Delete a comment                                               |         |
| **Fetch Page Comment**  | `fetch_page_comment`  | Retrieve a comment by its ID                                   |         |
| **List Block Comments** | `list_block_comments` | List comments on a block or page                               |         |
| **Update Page Comment** | `update_page_comment` | Update a comment's rich text content                           |         |

### Database

| Operation                    | ID                         | Description                                           | Trigger |
| ---------------------------- | -------------------------- | ----------------------------------------------------- | ------- |
| **Create Page Database**     | `create_page_database`     | Create a new database as a child of a page            |         |
| **Fetch Database Metadata**  | `fetch_database_metadata`  | Retrieve a database's metadata and schema             |         |
| **Query Notion Database**    | `query_notion_database`    | Query a database to retrieve pages                    |         |
| **Update Database Metadata** | `update_database_metadata` | Update a database's title, description, or properties |         |

### File

| Operation                 | ID                      | Description                                   | Trigger |
| ------------------------- | ----------------------- | --------------------------------------------- | ------- |
| **Create File Upload**    | `create_file_upload`    | Initiate a file upload and get an upload URL  |         |
| **Get Async Task Status** | `get_async_task_status` | Get the status of an asynchronous Notion task |         |

### Page

| Operation                  | ID                       | Description                                                   | Trigger |
| -------------------------- | ------------------------ | ------------------------------------------------------------- | ------- |
| **Create Notion Page**     | `create_notion_page`     | Create a new page in a database or as a child of another page |         |
| **Fetch Page Properties**  | `fetch_page_properties`  | Retrieve a page's properties                                  |         |
| **Fetch Page Property**    | `fetch_page_property`    | Retrieve a single property value from a page                  |         |
| **Update Page Properties** | `update_page_properties` | Update a page's properties, icon, or cover                    |         |

### User

| Operation                      | ID                           | Description                                       | Trigger |
| ------------------------------ | ---------------------------- | ------------------------------------------------- | ------- |
| **Fetch Bot Integration User** | `fetch_bot_integration_user` | Retrieve the bot user for the current integration |         |
| **Fetch Workspace User**       | `fetch_workspace_user`       | Retrieve a user by ID                             |         |
| **List Workspace Users**       | `list_workspace_users`       | List all users in the workspace                   |         |

### View

| Operation                | ID                     | Description                             | Trigger |
| ------------------------ | ---------------------- | --------------------------------------- | ------- |
| **Fetch Database View**  | `fetch_database_view`  | Retrieve a specific database view       |         |
| **List Database Views**  | `list_database_views`  | List all views for a database           |         |
| **Update Database View** | `update_database_view` | Update a database view's name or layout |         |

### Workspace

| Operation                      | ID                           | Description                         | Trigger |
| ------------------------------ | ---------------------------- | ----------------------------------- | ------- |
| **Search Pages and Databases** | `search_pages_and_databases` | Search pages and databases by title |         |

### Other

| Operation               | ID                    | Description                                                          | Trigger |
| ----------------------- | --------------------- | -------------------------------------------------------------------- | ------- |
| **On Comment Created**  | `on_comment_created`  | Trigger: fires when new comments appear on a specific block or page. | Yes     |
| **On Database Created** | `on_database_created` | Trigger: fires when new databases are created in the workspace.      | Yes     |
| **On Database Item**    | `on_database_item`    | Trigger: polls a Notion database and fires for new or updated items. | Yes     |
| **On Page Created**     | `on_page_created`     | Trigger: fires when new pages are created in the workspace.          | Yes     |
| **On Page Updated**     | `on_page_updated`     | Trigger: fires when existing pages are updated.                      | Yes     |
