# Notion

## 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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.eesel.ai/integrations/notion.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.