---
title: Notion
description: Connect your Notion workspaces to SurfSense
---

# Notion OAuth Integration Setup Guide

This guide walks you through setting up a Notion OAuth integration for SurfSense.

## Step 1: Access Notion Integrations

1. Navigate to [notion.so/profile/integrations](https://notion.so/profile/integrations)
2. Click the **"New integration"** button

![Notion Integrations Page](/docs/connectors/notion/notion-integrations-page.png)

## Step 2: Configure New Integration

Fill in the integration details:

| Field | Value |
|-------|-------|
| **Integration Name** | `SurfSense` |
| **Associated workspace** | Select your workspace |
| **Type** | `Public` |
| **Company name** | Your company name |
| **Website** | Your website URL |
| **Tagline** | Brief description |
| **Privacy Policy URL** | Your privacy policy URL |
| **Terms of Use URL** | Your terms of use URL |
| **Email** | Your developer email |
| **Logo** | Upload a 512x512 logo |

### OAuth Redirect URI

Under **OAuth domains & URIs**, set the **Redirect URI** to:

```
http://localhost:8000/api/v1/auth/notion/connector/callback
```

Click **Save** to create the integration.

![New Integration Form](/docs/connectors/notion/notion-new-integration-form.png)

## Step 3: Get OAuth Credentials & Configure Capabilities

After creating the integration, you'll see the configuration page with your credentials:

1. Copy your **OAuth Client ID**
2. Copy your **OAuth Client Secret** (click Refresh if needed)

### Set Required Capabilities

Enable the following capabilities:

| Capability Type | Required Setting |
|----------------|------------------|
| **Content Capabilities** | Read content |
| **Comment Capabilities** | Read comments |
| **User Capabilities** | Read user information including email addresses |

Click **Save** to apply the capabilities.

![Integration Configuration](/docs/connectors/notion/notion-integration-config.png)

---

## Running SurfSense with Notion Connector

Add the Notion environment variables to your Docker run command:

```bash
docker run -d -p 3000:3000 -p 8000:8000 \
  -v surfsense-data:/data \
  # Notion Connector
  -e NOTION_OAUTH_CLIENT_ID=your_notion_client_id \
  -e NOTION_OAUTH_CLIENT_SECRET=your_notion_client_secret \
  -e NOTION_REDIRECT_URI=http://localhost:8000/api/v1/auth/notion/connector/callback \
  --name surfsense \
  --restart unless-stopped \
  ghcr.io/modsetter/surfsense:latest
```
