> Index of every Falcon docs page, for assistants: https://falcon.com/docs/llms.txt

# Notion

Search and edit the Notion pages and databases a person shares, add comments, and start a workflow when a page or data source is edited.

## What it can do

- Read: **Retrieve the token's bot user**, **List users**, **Retrieve a user**, **Search shared pages and data sources**, **Retrieve a page**, **Retrieve a page property**, **Retrieve a block**, **Retrieve block children**, **Retrieve a database**, **Retrieve a data source**, **Query a data source**, **List comments** and **Retrieve a comment**.
- Change: **Create a page**, **Update a page**, **Trash or restore a page**, **Append block children** and **Create a comment**.

People choose which pages and databases to share in Notion's page picker. Access is those, plus the permissions below. Database rows are read with **Query a data source**. The older database query is not included. One list is one page, not the whole workspace.

## What can start a workflow

- **Page edited** and **Data source edited**.
- Studio compares a search with the last one it saved. The first check is a baseline and starts nothing.
- Notion can send its own notices, but those are created in Notion's developer settings, not by an action here. This app does not take those notices.

## How to connect

Open **Connections**, then **Apps**. In the **Apps** heading, search with **Search apps to add** and choose **Add** on Notion.

When the panel offers **Who signs in**, pick **Sign in as the company (one account for every agent)** or **Each person signs in to their own account when first needed**.

Read what it asks for. If it has not said, the panel says **You'll see what Notion asks for on its own sign-in page.** Choose **Continue to Notion** and finish there. Do not paste a password into Studio. When it works, the row says **Connected**.

If it says **This app can't be connected here yet: it needs a sign-in setup this server doesn't have.** or **Connecting Notion opens soon on this server.**, this server cannot sign Notion in yet. If you do not see **Add**, ask an admin to add Notion.

## What it asks for

Notion asks for capabilities, not a list on the sign-in address. They are **read content**, **update content**, **insert content**, **read comments**, **insert comments**, and **read user information without email** (`read_content`, `update_content`, `insert_content`, `read_comments`, `insert_comments`, `read_user_without_email`).

## Related

- [HubSpot](https://falcon.com/docs/app-hubspot)
- [Google Drive](https://falcon.com/docs/app-google-drive)
- [Connections](https://falcon.com/docs/connections)