Skip to main content

​
Connecting Dropbox

1

Open the Dropbox panel

In the Vault, click the Dropbox tab in the sidebar, or use + New, then Import from Dropbox.
2

Click Connect Dropbox

You see: “Browse, import, and sync files directly from your Dropbox account into this vault.” Click the button.
3

Grant permissions

You are redirected to Dropbox OAuth. Approve read access to your files. Required scopes: account_info.read, files.metadata.read, files.content.read.
4

Verify connection

The panel shows your connected account email with a green “Connected” label and a file browser.
Dropbox panel

Dropbox panel in connected state with folder browser

​
Browsing Your Dropbox

Once connected, the panel shows a full file browser:

​
File Icons

Files display with color-coded icons based on type:
  • Images (jpg, jpeg, png, gif, webp, svg) — Purple
  • Documents (pdf, doc, docx, txt, md) — Blue
  • Other files — Gray

​
Pagination

The browser auto-paginates Dropbox results (up to 2,000 entries on initial load). For larger folders, cursor-based pagination loads additional batches.

​
Importing Files (One-Time)

1

Browse to your files

Navigate through your Dropbox folders.
2

Select files

Click individual files or use “Select all files” to select everything in the current view. Selected files show a blue highlight.
3

Click Import to vault

A footer bar shows “X file(s) selected” with an Import to vault button.
4

Files are downloaded and uploaded

Each file is downloaded from Dropbox (using a temporary download link) and uploaded to the current vault. Toast confirms: “N file(s) imported”

​
Setting Up Folder Sync

Folder sync creates an ongoing link between a Dropbox folder and a vault.
1

Navigate to the folder

Browse to the Dropbox folder you want to sync.
2

Click Sync this folder

A sync dialog opens.
3

Choose target vault

Select which vault to sync into from the dropdown: Default, Sales, Science, Marketing, or any custom vault.
4

Click Sync Now

The sync runs as a background task. You see a toast: “Adding and syncing…” You do not need to keep the page open.

​
What Sync Does

  • Downloads all files from the Dropbox folder recursively
  • Creates a matching folder structure in your target vault
  • Files are automatically indexed for Brain AI search
  • The synced folder appears in the “Synced Folders” list with a vault badge (e.g., “Sales”)

​
Re-syncing

To pull new files added since the last sync:
  1. Find the folder in the Synced Folders list
  2. Click the re-sync button
  3. New and modified files are downloaded and added

​
Removing a Sync

Click the trash icon on any synced folder to remove the sync relationship. This does not delete files already imported into the vault. Toast confirms: “Folder removed”

​
Synced Folders List

The top of the Dropbox panel shows all synced folders with:
Synced folder with vault badge

Synced folder showing the target vault badge

​
Downloading Files

While browsing your Dropbox, you can download any file directly by clicking the download button next to it. This downloads from Dropbox without importing into the vault.

​
Disconnecting

Click Disconnect in the panel header to remove your Dropbox connection. This:
  • Removes your OAuth tokens
  • Does not delete files already imported into vaults
  • Does not remove synced folder configurations (they become inactive)
Toast confirms: “Dropbox disconnected”

​
Troubleshooting

​
”Invalid client_id” Error

Ensure your Dropbox app has the correct scopes enabled:
  • account_info.read
  • files.metadata.read
  • files.content.read
Also verify your redirect URI includes your domain (e.g., https://www.ospribrain.com/api/dropbox/callback).

​
Sync Not Completing

  • Syncs run in the background — wait a few minutes for large folders
  • Check the Synced Folders list for status updates
  • Try clicking re-sync on the folder

​
”Navigate into a folder first”

You need to be inside a folder (not at the Dropbox root) to set up sync. Click into a specific folder first.