ClickUp OAuth Integration Setup Guide

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

Step 1: Access ClickUp API Settings

1. Open your ClickUp workspace
2. Navigate to Settings (gear icon) → ClickUp API
3. You'll see the ClickUp API Settings page

Step 2: Create an App

1. Click "+ Create an App" in the top-right corner
2. Fill in the app details:

3. Click "Save" to create the app

Step 3: Get OAuth Credentials

After creating the app, you'll see your credentials:

1. Copy your Client ID
2. Copy your Client Secret (click "Show" to reveal, or "Regenerate" if needed)

Running SurfSense with ClickUp Connector

Add the ClickUp environment variables to your Docker run command:

docker run -d -p 3000:3000 -p 8000:8000 \
  -v surfsense-data:/data \
  # ClickUp Connector
  -e CLICKUP_CLIENT_ID=your_clickup_client_id \
  -e CLICKUP_CLIENT_SECRET=your_clickup_client_secret \
  -e CLICKUP_REDIRECT_URI=http://localhost:8000/api/v1/auth/clickup/connector/callback \
  --name surfsense \
  --restart unless-stopped \
  ghcr.io/modsetter/surfsense:latest