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

# Notion

> Connect Notion to Iru Compliance with an internal integration token to collect workspace, page, database, and member-access evidence for control assessments.

### About Notion

The **Notion** connector reads **page metadata**, **database schemas**, **workspace membership**, and integration configuration so you can map knowledge-base evidence to controls in Iru Compliance. Authentication uses a **Notion internal integration token** (sometimes called a connection secret) generated from **[My integrations](https://www.notion.com/my-integrations)**.

### How It Works

Notion expects the token in the **`Authorization`** header:

```http theme={null}
Authorization: Bearer YOUR_INTEGRATION_TOKEN
```

Internal integrations only reach content that you explicitly **share** with the integration. Plan sharing deliberately - typically by attaching the integration at a **parent page** so children inherit access.

| Detail             | Value                                             |
| ------------------ | ------------------------------------------------- |
| **Category**       | Productivity / documentation                      |
| **Authentication** | Bearer token (internal integration)               |
| **Workspace role** | Only **workspace owners** can create integrations |

Documentation: [Create integrations](https://www.notion.com/help/create-integrations-with-the-notion-api), [Authorization overview](https://developers.notion.com/docs/authorization), [API reference](https://developers.notion.com/reference).

### Prerequisites

* **Workspace owner** rights (needed to create integrations).
* A clear list of **pages or databases** compliance evidence should include.

### Connect Notion to Iru

<Tabs>
  <Tab title="Notion">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Sign in to Notion">
        Sign in at [notion.so](https://www.notion.so) with a user who can create **internal integrations** for the workspace you want Iru to read.
      </Step>

      <Step title="Open My integrations">
        Visit **[notion.com/my-integrations](https://www.notion.com/my-integrations)**, or in the Notion app open **Settings** → **Connections** and follow the path to **Create** or manage integrations.
      </Step>

      <Step title="Configure the integration">
        Create a new integration. Name it (for example **Iru Compliance**), assign it to the **correct workspace**, and enable capabilities your controls need: at minimum **Read content**, and **Read user information including email addresses** when membership evidence matters.
      </Step>

      <Step title="Save and copy the internal integration secret">
        **Save** the integration, then copy the **internal integration secret**. Treat it like a password; it does not expire unless you rotate or delete the integration.
      </Step>

      <Step title="Share content with the integration">
        Open each top-level page or database → **`⋯`** → **Connections** → pick **Iru Compliance**. Sharing a parent page reduces duplicate work for nested docs.

        Without explicit shares, the integration legitimately sees **nothing**, even if your humans can read the pages.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Notion**](#notion) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Notion">
        Find **Notion** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Paste the integration secret">
        Paste the internal integration **secret** into the bearer-token step.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Bearer Token**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Notion** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Re-copy the secret, ensure the integration was not deleted or rotated.
  </Accordion>

  <Accordion title="Missing databases">
    Re-open each parent page and confirm **Connections** lists your integration.
  </Accordion>

  <Accordion title="Integration missing from menu">
    Only workspace owners manage integrations - confirm you created it in the intended workspace.
  </Accordion>
</AccordionGroup>

### Considerations

<CardGroup cols={2}>
  <Card title="Rotate secrets on your schedule and update Iru…" icon="circle-info">
    Rotate secrets on your schedule and update Iru immediately afterward.
  </Card>

  <Card title="Iru reads metadata exposed to the token: it does not…" icon="shield">
    Iru reads metadata exposed to the token - it does not silently edit pages or invites.
  </Card>
</CardGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>