# Notion

> Connect Notion to train your agent on your team's wiki, knowledge base, and documentation.

## Connecting Notion

Notion connects via an internal integration token:

1. Go to **Integrations > Notion**
2. Create a Notion integration at [notion.so/my-integrations](https://www.notion.so/my-integrations)
3. Copy the **Internal Integration Token**
4. Paste the token in eesel AI and click **Connect**
5. In Notion, share the pages you want to sync with your integration

### Prerequisites

* A Notion workspace with admin or member access
* An internal integration created in Notion settings
* Pages shared with the integration

### Important: Share pages with the integration

After creating your Notion integration, you must explicitly share each page (or parent page) with it:

1. Open the page in Notion
2. Click **Share** in the top right
3. Invite your integration by name
4. Pages nested under shared pages are automatically included

## What gets synced

| Content type | Description                                |
| ------------ | ------------------------------------------ |
| **Pages**    | Full text content from shared Notion pages |

All page types are supported — text, databases, lists, etc. Nested sub-pages under shared parent pages are included automatically.

## Sync frequency and updates

* Content is periodically re-synced to pick up edits
* New pages added under shared parent pages are automatically picked up
* You can manually trigger a re-sync from the integration settings

## Tips

**Share a top-level page.** Instead of sharing individual pages, share a high-level parent page. All nested sub-pages will be included automatically.

**Keep your knowledge base organized.** Well-structured Notion pages with clear headings produce better results than long, unstructured pages.

**Update the source, not the agent.** When information changes, update it in Notion and let the sync pick it up — don't try to correct the agent's knowledge through instructions alone.

## Troubleshooting

**Pages not appearing?**

* Check that the pages are shared with your Notion integration
* Verify the integration token is correct
* Try manually triggering a re-sync

**Content seems outdated?**

* Trigger a manual re-sync from the integration settings
* Check that the page was actually updated in Notion
