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

# Notion

> Access pages and databases from Notion

## How it works

The Notion connector uses the Notion search API to fetch all pages that the connector has access to within a workspace.
For follow up indexing runs, the connector only retrieves pages that have been updated since the last indexing attempt.
Indexing is configured to run every **10 minutes**, so page updates should appear within 10 minutes.

## Setting up

### Authorization

In order to authorize Onyx to connect to your Notion workspace, you'll need to create a new integration in Notion,
which will then provide you with a secret token.

These steps are pulled from [this Notion guide](https://developers.notion.com/docs/create-a-notion-integration)
which you can also follow.

#### Step 1: Create an integration

<Steps>
  <Step title="Visit integrations page">
    Visit [https://www.notion.com/my-integrations](https://www.notion.com/my-integrations) in your browser.
  </Step>

  <Step title="Create new integration">
    Click the + New integration button.
  </Step>

  <Step title="Name the integration">
    Name the integration (something like "Onyx" could work).
  </Step>

  <Step title="Set capabilities">
    Select "Read content" as the only capability required for Onyx.
  </Step>

  <Step title="Submit">
    Click Submit to create the integration.
  </Step>
</Steps>

On the next page, you'll find your Notion integration token, also called an API key.
You'll need this token to configure Onyx to index Notion, so make a copy of it.

The integration has been added to the workspace, so any member can share pages and databases with it.
There's no requirement to be an Admin to share information with an integration.

<img className="rounded-image" src="https://mintcdn.com/danswer/24Ocig51qMqahMaT/assets/admins/connectors/notion/NotionCreateIntegration.gif?s=180a4a3175ca54fcd9751daf75010fbf" alt="Creating a Notion internal integration in the Notion settings" width="929" height="750" data-path="assets/admins/connectors/notion/NotionCreateIntegration.gif" />

#### Step 2: Share pages/databases with your integration

Now that you've created an integration, you need to grant it access to Notion pages/databases.
To keep your information secure, integrations don't have access to any pages or databases in the workspace at first.
You must share specific pages with an integration in order for Onyx to access those pages.

To share a page/database with your integration:

<Steps>
  <Step title="Navigate to page">
    Go to the page/database in your workspace.
  </Step>

  <Step title="Access page menu">
    Click the `•••` on the top right corner of the page.
  </Step>

  <Step title="Add connections">
    Scroll to the bottom of the pop-up and click Add connections.
  </Step>

  <Step title="Select integration">
    Search for and select the new integration in the `Search for connections...` menu.
  </Step>

  <Step title="Note about child pages">
    If you've added a page, all child pages also become accessible to Onyx.
  </Step>
</Steps>

If you've added a database, all rows (and their children) become accessible to Onyx.

<img className="rounded-image" src="https://mintcdn.com/danswer/24Ocig51qMqahMaT/assets/admins/connectors/notion/NotionAddConnector.png?fit=max&auto=format&n=24Ocig51qMqahMaT&q=85&s=72a2f6330c5a2ffde1a2ad3eac6cbeb6" alt="Adding the Onyx integration to a Notion workspace or page" width="489" height="968" data-path="assets/admins/connectors/notion/NotionAddConnector.png" />

Once you've granted access to a page/database, you can start configuring Onyx to index those databases.

### Indexing

<Steps>
  <Step title="Open Notion connector">
    Navigate to the Admin Panel and select the **Notion** connector.
  </Step>

  <Step title="Enter Integration Token">
    In **Step 1**, provide the **Integration Token Secret** you obtained in the "Authorization" steps above:

    <img className="rounded-image" src="https://mintcdn.com/danswer/24Ocig51qMqahMaT/assets/admins/connectors/notion/NotionAuth.png?fit=max&auto=format&n=24Ocig51qMqahMaT&q=85&s=5a3f247125c6c94a1ea9064bddeb33db" alt="Onyx Notion connector authentication step to connect integration" width="1694" height="912" data-path="assets/admins/connectors/notion/NotionAuth.png" />
  </Step>

  <Step title="Connect and index">
    Click the `Connect` button! Your content will then be pulled into Onyx every **10** minutes.

    <img className="rounded-image" src="https://mintcdn.com/danswer/24Ocig51qMqahMaT/assets/admins/connectors/notion/NotionIndex.png?fit=max&auto=format&n=24Ocig51qMqahMaT&q=85&s=43c11f7ec38b5a4bd5a20cc436c722f5" alt="Onyx Notion connector indexing options and selection screen" width="1708" height="718" data-path="assets/admins/connectors/notion/NotionIndex.png" />
  </Step>
</Steps>

Note - As mentioned, the Notion connector currently indexes everything it has access to.
If you want to limit specific content being indexed, simply unshare the database from Notion with the integration.