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

# Notion

> Learn how to connect your Opal instance with Notion.

With Opal's Notion integration, you can:

* Create audit tickets for access requests
* Propagate access to Opal using Notion ticket

## Configuration requirements

To connect Notion with Opal, you must:

* Be an Opal Admin

## 1. Retrieve Notion integration token

[Create an integration in Notion](https://www.notion.so/my-integrations), then copy the [internal integration token](https://www.notion.com/help/add-and-manage-connections-with-the-api).

## 2. Configure Notion databases

For each ticketing project, you should maintain a separate Notion database using the following schema. Connect each database to the connection you used to create the Notion integration token.

| Field | Type |
| - | - |
| Title | Text |
| Status | Status (Open, In Progress, Completed) |
| Reporter | Person |
| Priority | Multi-select (Low, Medium, High, Urgent) |
| Created time *(Notion default)* | Created time |
| Last edited time *(Notion default)* | Last edited time |

For example, to use Notion to track both auditing and propagation tickets, you'd create separate databases for **Opal \<> Propagate Integration** and **Opal \<> Audit Integration**, and connect them to the same integration.

![](https://mintcdn.com/opalsecurity/NnBzBBMHXCD_zzBD/images/docs/62766dd86b9a2346e301e8d31a6b036edbfa2331343187763a093c71b4935200-notion-audit.png?fit=max\&auto=format\&n=NnBzBBMHXCD_zzBD\&q=85\&s=f65bb3b49465411bf8e806e96170dca6)

## 3. Create Notion app in Opal

In Opal, go to **Configuration** > **Organization Settings** > **Productivity Integrations** and select **Connect** next to **Notion**.

![](https://mintcdn.com/opalsecurity/Pkvuzx-mF6rBONJE/images/docs/821b311654c9c338f4f749225ecdc057c937c53d5177be134760dd5b1f866be0-notion.png?fit=max\&auto=format\&n=Pkvuzx-mF6rBONJE\&q=85\&s=008b92e9d87250ff1a831aea3d843512)

Enter the integration token you saved from step 1, then save the integration.

## Create audit tickets

To create audit tickets in Notion for every access request, enable **Notion** as a ticketing provider under **Configuration** > **Organization Settings** > **Access Requests**. You'll see the Notion databases you configured show as options after saving the Notion token.

## Propagate access with tickets

See the ticket propagation guide to learn how to propagate access with tickets connected to your Notion databases.

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.