## Notion integration

Integrating Notion with Frontegg allows your application to authenticate users via OAuth 2.0 and interact with their Notion workspaces — reading pages, creating content, querying databases, and posting comments on their behalf.

Prerequisites
- A Notion account
- Access to the [Notion integrations portal](https://www.notion.so/my-integrations)


### Connect Notion

#### Step 1: Open the Notion integrations portal

Navigate to [notion.so/my-integrations](https://www.notion.so/my-integrations). Sign in with your Notion account if prompted, then click **Create a new integration**.

![Notion integrations portal](/assets/notion-1.1cf30295ff0ce24c30b7e1ee6a61d9d708e201338c0e0338981394d5b347e0a1.1ce25488.png)

#### Step 2: Fill in the integration details

Fill in the following fields:

- **Integration name**: Enter a name for your integration (for example, `Frontegg Integration`).
- **Icon**: Upload a square PNG or JPG image (512×512 px recommended).
- **Associated workspace**: Select the workspace where you will test and develop this integration.


![Notion new integration form](/assets/notion-2.ea29d6c90596db43bfd456bae45686e3e1a6b301739c12415393ec6631d84642.1ce25488.png)

#### Step 3: Configure redirect URIs

In the **Authorization (OAuth)** section, enter the following redirect URIs one at a time and press Enter after each:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


Click **Create** to submit the form.

![Notion redirect URIs configuration](/assets/notion-3.cb6a3a65eac00f9f3c6c9aa4be62f35d9c229cc3670baa93bf2852a09478e7d1.1ce25488.png)

#### Step 4: Integration created

A confirmation dialog appears. Click **Configure integration settings** to proceed to the integration's settings page.

![Notion integration created dialog](/assets/notion-4.b6219a26340e8ccee7f5fd092e6100f48af8515eeff4f1833bb6ae9dac9fa6e3.1ce25488.png)

#### Step 5: Copy your OAuth Client ID

On the settings page, find the **Authorization (OAuth)** section. Your **OAuth Client ID** is displayed there. Click **Copy** to copy it for use in the Frontegg portal.

![Notion OAuth Client ID](/assets/notion-5.2e70c9b77dcc82f02ccf2fe528389eb206a90607b06a303f4f7d8aa15f54973c.1ce25488.png)

#### Step 6: Copy your OAuth Client Secret

Click **Show** next to **OAuth Client Secret**, confirm the prompt, then click **Copy** to save the secret.

Keep your credentials secure
The Client Secret is shown only once. Store it immediately in a secure location. Never share or commit it to version control.

![Notion OAuth Client Secret](/assets/notion-6.ff67114d4752dce34ec825cc242c13ff87ce1dc41c3b9be8b692fe6b4682a754.1ce25488.png)

#### Step 7: Configure capabilities

Scroll down to the **Capabilities** section and select the capabilities your integration requires. Notion uses capability-based permissions instead of traditional OAuth scopes — the selected capabilities are shown to users when they authorize your integration.

| Capability | Description |
|  --- | --- |
| **Read content** | Read pages, databases, and blocks |
| **Update content** | Update existing pages and blocks |
| **Insert content** | Create new pages, databases, and blocks |
| **Read comments** | Read comments on blocks and pages |
| **Insert comments** | Create comments on blocks and pages |
| **Read user information including email addresses** | Access user profile information and email addresses |


![Notion capabilities configuration](/assets/notion-7.164f3c2679291bb063f865295680e353512b997f54bfb68c877f8bfd43c2e4b7.1ce25488.png)

#### Step 8: Save the integration

Click **Save** to apply the capability settings. A confirmation message appears when the changes are saved.

![Notion integration saved](/assets/notion-8.5b6e4504f9cb7f0ba4e046147f44bfde0001e55f65f39398c03dc575d2a0c95f.1ce25488.png)

### Configure the Frontegg portal

Once you have your **OAuth Client ID** and **OAuth Client Secret**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to **[ENVIRONMENT]** → **Integrations** → **Notion**.
2. Enter the **OAuth Client ID** in the **Client ID** field and the **OAuth Client Secret** in the **Client Secret** field.
3. Select the required **capabilities**.
4. Click **Save**.


### Additional resources

- [Notion OAuth 2.0 documentation](https://developers.notion.com/docs/authorization)
- [Notion integrations portal](https://www.notion.so/my-integrations)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)