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

---
title: ClickUp
description: Connect your ClickUp workspace to SurfSense
---

# 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

![ClickUp API Settings Page](/docs/connectors/clickup/clickup-api-settings.png)

## Step 2: Create an App

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

| Field | Value |
|-------|-------|
| **App Name** | `SurfSense` |
| **Redirect URL(s)** | `localhost:8000` |

3. Click **"Save"** to create the app

![App Created with Credentials](/docs/connectors/clickup/clickup-app-credentials.png)

## 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)

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

---

## Running SurfSense with ClickUp Connector

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

```bash
CLICKUP_CLIENT_ID=your_clickup_client_id
CLICKUP_CLIENT_SECRET=your_clickup_client_secret
CLICKUP_REDIRECT_URI=http://localhost:8000/api/v1/auth/clickup/connector/callback
```

Then restart the services:

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