Skip to main content

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.

​
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.

​
How it works

Notion expects the token in the Authorization header: 
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.
DetailValue
CategoryProductivity / documentation
AuthenticationBearer token (internal integration)
Workspace roleOnly workspace owners can create integrations
Documentation: Create integrations, Authorization overview, API reference.

​
Prerequisites

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

​
Connect Notion to Iru

​
Notion

1

Create an internal integration

Visit notion.com/my-integrations (or Settings → Connections → Create). Name the integration (for example Iru Compliance), assign it to the correct workspace, and enable capabilities such as Read content plus Read user information including email addresses when membership evidence matters.Save, then copy the internal integration secret. Treat it like a password - it does not expire unless you rotate or delete the integration.
2

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.

​
Iru Compliance

1

Open Sources

In Iru Compliance, on the left navigation bar, expand Compliance and select Sources.
Left navigation: Compliance expanded, Sources selected
2

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.
3

Paste the integration secret

Paste the internal integration secret into the bearer-token step.
4

Confirm the source is Active

Submit the form. When validation succeeds, the Notion card shows Active.

​
Troubleshooting

Check pop-up blocker settings for the Iru site and try again.
Re-copy the secret, ensure the integration was not deleted or rotated.
Re-open each parent page and confirm Connections lists your integration.
Only workspace owners manage integrations - confirm you created it in the intended workspace.

​
Considerations

Rotate secrets on your schedule and update Iru…

Rotate secrets on your schedule and update Iru immediately afterward.

Iru reads metadata exposed to the token: it does not…

Iru reads metadata exposed to the token - it does not silently edit pages or invites.

​
See also