SurfSense/surfsense_web/content/docs/connectors/confluence.mdx

---
title: Confluence
description: Connect your Confluence spaces to SurfSense
---

# Confluence OAuth Integration Setup Guide

This guide walks you through setting up an Atlassian OAuth 2.0 (3LO) integration for SurfSense to connect your Confluence spaces.

## Step 1: Access the Developer Console

1. Navigate to [developer.atlassian.com](https://developer.atlassian.com)
2. Click your profile icon in the top-right corner
3. Select **"Developer console"** from the dropdown

![Atlassian Developer Console Access](/docs/connectors/atlassian/atlassian-dev-console-access.png)

## Step 2: Create a New OAuth 2.0 Integration

1. In the Developer Console, under **My apps**, click the **"Create"** button
2. Select **"OAuth 2.0 integration"** from the dropdown

![Create OAuth 2.0 Integration](/docs/connectors/atlassian/atlassian-create-app.png)

## Step 3: Name Your Integration

1. Enter **Name**: `SurfSense`
2. Check the box to agree to Atlassian's developer terms
3. Click **"Create"**

<Callout type="info">
  New OAuth 2.0 integrations use rotating refresh tokens, which improve security by limiting token validity and enabling automatic detection of token reuse.
</Callout>

![Create New Integration Form](/docs/connectors/atlassian/atlassian-name-integration.png)

## Step 4: Configure Callback URL

1. In the left sidebar, click **"Authorization"**
2. Under **Callback URLs**, enter the redirect URI:
   ```
   http://localhost:8000/api/v1/auth/confluence/connector/callback
   ```
3. Click **"Save changes"**

<Callout type="info">
  You can enter up to 10 redirect URIs, one per line.
</Callout>

![Authorization Callback URLs](/docs/connectors/atlassian/atlassian-authorization.png)

## Step 5: Configure API Permissions

1. In the left sidebar, click **"Permissions"**
2. You'll see a list of available APIs including Confluence API

![Permissions Overview](/docs/connectors/atlassian/atlassian-permissions.png)

## Step 6: Configure Confluence API Scopes

1. Click **"Configure"** next to **Confluence API**

### Classic Scopes

Select the **"Classic scopes"** tab and enable:

| Scope Name | Code | Description |
|------------|------|-------------|
| Read user | `read:confluence-user` | View user information in Confluence that you have access to, including usernames, email addresses and profile pictures |

![Confluence API Classic Scopes](/docs/connectors/atlassian/confluence/atlassian-confluence-classic-scopes.png)

### Granular Scopes

Select the **"Granular scopes"** tab and enable:

| Scope Name | Code | Description |
|------------|------|-------------|
| View pages | `read:page:confluence` | View page content |
| View comments | `read:comment:confluence` | View comments on pages or blogposts |
| View spaces | `read:space:confluence` | View space details |

4. Click **"Save"**

![Confluence API Granular Scopes](/docs/connectors/atlassian/confluence/atlassian-confluence-granular-scopes.png)

## Step 7: Get OAuth Credentials

1. In the left sidebar, click **"Settings"**
2. Copy your **Client ID** and **Client Secret**

<Callout type="warn">
  Never share your client secret publicly.
</Callout>

---

## Running SurfSense with Confluence Connector

Add the Atlassian credentials to your `.env` file (created during [Docker installation](/docs/docker-installation)):

```bash
ATLASSIAN_CLIENT_ID=your_atlassian_client_id
ATLASSIAN_CLIENT_SECRET=your_atlassian_client_secret
CONFLUENCE_REDIRECT_URI=http://localhost:8000/api/v1/auth/confluence/connector/callback
```

Then restart the services:

```bash
docker compose up -d
```