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

# Connect Notion

> Connect your Notion so your agent can look up what your team already documented and log what happened in the conversation.

If your team keeps prices, policies or the catalog in Notion, connecting it means your agent answers from that, not from what it assumes. It queries the right database and replies with real information.

It writes too: every conversation can land as a row in the database you choose, with what it gathered during the call.

## What you need first

* A **Notion** account and permission to connect integrations in that workspace.
* The **pages and databases** you want your agent to use. During the authorization you pick exactly which ones to share: Notion does not grant access to everything by default.
* The **Starter** plan or higher in Ryvo, with the Engine module active.

## How to connect it

<Steps>
  <Step title="Open Settings › Integrations">
    In the portal, go to **Settings** and then **Integrations**. Find the **Notion** card.
  </Step>

  <Step title="Click Connect app">
    Notion's authorization screen opens in a new window. Meanwhile the card shows **In progress**.
  </Step>

  <Step title="Pick WHICH pages to share">
    This is the step that decides whether the integration will be useful. Notion asks you to select the pages and databases you grant access to: tick the ones your agent needs to read or write. Anything you leave unticked, your agent cannot see.
  </Step>

  <Step title="Come back to Ryvo">
    You land back on the Integrations screen on your own and the card turns to **Connected**. Notion asks nothing else inside Ryvo.
  </Step>
</Steps>

## What your agent can do once it is connected

| Action             | What it does in the conversation                                    |
| ------------------ | ------------------------------------------------------------------- |
| **Query database** | Searches a Notion database so it answers with real information.     |
| **Find page**      | Finds a page by its title when it needs to read the contents.       |
| **Add record**     | Adds a row to a database with what it gathered in the conversation. |

Actions are turned on one by one from **View actions** and the [**Tools**](/guides/agents/tools) section of the builder, with a cap of **10 integration actions per agent**.

## What to do if something fails

| What you see                                           | What happened                                                  | What to do                                                                                                                                      |
| ------------------------------------------------------ | -------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| The agent says it cannot find the page or the database | You did not share it during the authorization                  | In Notion, open the page, use the **•••** menu and share it with the Ryvo integration. You can also click **Reconnect** and tick it in the list |
| **Add record** fails                                   | The database properties do not match what the agent is sending | Check the column names in the database and mention them in the agent's instructions                                                             |
| **The account stopped responding. Connect it again.**  | Someone removed the integration from Notion's settings         | Click **Reconnect**: Ryvo revokes the old access and opens the authorization from scratch                                                       |