Dropbox
Connect your Dropbox to SurfSense
Dropbox OAuth Integration Setup Guide
This guide walks you through setting up a Dropbox OAuth integration for SurfSense using the Dropbox App Console.
Step 1: Access the Dropbox App Console
- Navigate to dropbox.com/developers/apps
- Sign in with your Dropbox account
Step 2: Create a New App
- Click "Create app"
- Fill in the app details:
| Field | Value |
|---|---|
| Choose an API | Select "Scoped access" |
| Choose the type of access | Select "Full Dropbox" |
| Name your app | SurfSense (or any unique name) |
- Click "Create app"
Step 3: Configure Redirect URI
- On your app's Settings page, scroll to the OAuth 2 section
- Under Redirect URIs, add:
http://localhost:8000/api/v1/auth/dropbox/connector/callback - Click "Add"
Step 4: Get App Key and Secret
On the same Settings page, you will find:
- App key - this is your
DROPBOX_APP_KEY - App secret - click "Show" to reveal, then copy. This is your
DROPBOX_APP_SECRET
Never share your app secret publicly or include it in code repositories.
Step 5: Configure Permissions
- Go to the Permissions tab of your app
- Enable the following scopes:
| Permission | Description |
|---|---|
files.metadata.read | View information about files and folders |
files.content.read | View and download file content |
files.content.write | Create, modify, and delete files |
account_info.read | View basic account information |
- Click "Submit" to save the permissions
All four permissions listed above are required. The connector will not authenticate successfully if any are missing.
Running SurfSense with Dropbox Connector
Add the Dropbox OAuth credentials to your .env file (created during Docker installation):
DROPBOX_APP_KEY=your_dropbox_app_key
DROPBOX_APP_SECRET=your_dropbox_app_secret
DROPBOX_REDIRECT_URI=http://localhost:8000/api/v1/auth/dropbox/connector/callbackThen restart the services:
docker compose up -d