SurfSense DocsDropbox
Import your Dropbox files into the SurfSense knowledge base
The Dropbox connector lets you pick files from Dropbox and index them into your knowledge base. It lives in the Documents sidebar's Import menu, not the connector catalog.
This setup is only needed on self-hosted deployments. On SurfSense Cloud, just use Import → Dropbox.
Step 1: Create a Dropbox App
- Navigate to dropbox.com/developers/apps and sign in
- Click "Create app" and fill in:
| Field | Value |
|---|---|
| Choose an API | "Scoped access" |
| Choose the type of access | "Full Dropbox" |
| Name your app | SurfSense (or any unique name) |
- Click "Create app"
Step 2: Configure the Redirect URI
- On your app's Settings page, scroll to the OAuth 2 section
- Under Redirect URIs, add:
http://localhost:3929/api/v1/auth/dropbox/connector/callbackhttp://localhost:3929 is the default public URL of a Docker install. If you run SurfSense manually, use your backend URL (http://localhost:8000); in production, use your public domain.
Step 3: Configure Permissions
- Go to the Permissions tab of your app
- Enable all of the following scopes and click "Submit":
| 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 |
All four permissions are required. The connector will not authenticate successfully if any are missing.
Step 4: Add the Credentials to SurfSense
On the Settings page, copy the App key and App secret (click "Show" to reveal), and add them to your .env file:
DROPBOX_APP_KEY=your_dropbox_app_key
DROPBOX_APP_SECRET=your_dropbox_app_secretRestart SurfSense, open Documents → Import → Dropbox, and authorize:
docker compose up -dNever share your app secret publicly or include it in code repositories.