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

# Installation

> Connect your Notion workspace to Rootly via OAuth to enable automated retrospective page creation, incident documentation, and database population.

## Before You Begin

<Callout icon="triangle-exclamation" color="#FEF08A">
  We recommend performing the installation with a **service account** to ensure the integration does not break if the installing user leaves the company. Ensure you are logged in as an **Admin** in Rootly. You will also need Editor or Owner access to the parent Notion page where Rootly will create pages.
</Callout>

## Connect Notion

To connect Notion to Rootly, you will authorize via OAuth and select which Notion pages Rootly is allowed to access. Rootly can only create pages within the pages you explicitly grant access to during this step.

<Steps>
  <Step title="Open Rootly Integrations">
    In Rootly, navigate to **Configuration → Integrations** and search for **Notion**.

    <Frame>
      <img alt="Rootly integrations page with Notion search" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-1.1.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=b13aad7441ac152696b6ebf9ac8d8f5a" width="331" height="509" data-path="images/integrations/notion/installation/image-1.1.png" />
    </Frame>

    <Frame>
      <img alt="Notion integration setup button" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-1.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=cdaa0a223f991774e120344a07eaeb9a" width="523" height="381" data-path="images/integrations/notion/installation/image-1.png" />
    </Frame>
  </Step>

  <Step title="Authorize in Notion">
    Click **Setup**. You will be redirected to Notion. Click **Select pages** to choose which pages Rootly can access.

    <Frame>
      <img alt="Notion OAuth authorization page" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-2.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=453bce0e99139c278c8e22ca7720c4cf" width="499" height="521" data-path="images/integrations/notion/installation/image-2.png" />
    </Frame>
  </Step>

  <Step title="Select Pages">
    Choose the parent pages where you want Rootly to create incident retrospective pages, then click **Allow access**.

    <Frame>
      <img alt="Notion page selection screen" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-3.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=08e70f188b41dcb6219e7e52c890818c" width="496" height="624" data-path="images/integrations/notion/installation/image-3.png" />
    </Frame>
  </Step>

  <Step title="Confirm Connection">
    You will be redirected back to Rootly with a success message confirming the integration is connected.

    <Frame>
      <img alt="Rootly showing Notion connected successfully" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-3.1.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=edcc823d543e0535cb978317fb4f8c83" width="954" height="485" data-path="images/integrations/notion/installation/image-3.1.png" />
    </Frame>
  </Step>
</Steps>

<Callout icon="circle-check" color="#DCFCE7">
  Your Notion workspace is now connected. You can verify the connection in Notion under **Settings and Members → Connections** — Rootly should appear in the list.
</Callout>

## Verify the Connection

After connecting, confirm in Notion that Rootly has been granted access:

1. Open the parent page you selected during authorization
2. Click the **⋯** menu → **Connections**
3. Confirm Rootly appears in the list

<Frame>
  <img alt="Notion connections panel showing Rootly" src="https://mintcdn.com/rootly/iGk9QgMwzZ9PnoIQ/images/integrations/notion/installation/image-4.png?fit=max&auto=format&n=iGk9QgMwzZ9PnoIQ&q=85&s=a167ebe466700f7d7a02d11bd15e2ca3" width="792" height="289" data-path="images/integrations/notion/installation/image-4.png" />
</Frame>

## Uninstall

**In Rootly:**

1. Go to **Configuration → Integrations** and find **Notion**
2. Click the **Connected** button to reveal the disconnect option
3. Click **Delete**

<Frame>
  <img src="https://mintcdn.com/rootly/QMD-dNqeYW4BA9dg/images/integrations/common/uninstall-connected.png?fit=max&auto=format&n=QMD-dNqeYW4BA9dg&q=85&s=dbb790e2576c8969bba96bc26c95265f" alt="Click the Connected button to reveal the Disconnect option" width="319" height="188" data-path="images/integrations/common/uninstall-connected.png" />
</Frame>

**In Notion** (to fully revoke access):

1. Go to **Settings and Members → Connections**
2. Find **Rootly** and click **Disconnect**

<Callout icon="circle-info" color="#DBEAFE">
  Disconnecting from Rootly does not remove existing Notion pages created by Rootly. Those pages remain in your Notion workspace.
</Callout>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Rootly is not showing in Notion Connections" icon="circle-exclamation">
    Ensure you granted access to the specific page during OAuth. Go to **Settings and Members → Connections** in Notion to confirm Rootly is listed. If missing, disconnect and reconnect the integration in Rootly. Also check that the page is not in a private or restricted workspace.
  </Accordion>

  <Accordion title="No pages are available during setup" icon="magnifying-glass">
    Notion only shows pages you have Editor or Owner access to. If the workspace has restricted pages, an admin must grant you access first. Try expanding parent pages in the selector to see nested pages, then restart the authorization flow.
  </Accordion>

  <Accordion title="Pages are not being created after running a workflow" icon="triangle-exclamation">
    Verify the parent page selected in the workflow action is one you granted access to during installation. Check workflow run logs under **Workflows → Your Workflow → View Runs** for error details. Re-authorize the integration if the connection has expired.
  </Accordion>
</AccordionGroup>
