Skip to main content

Authentication Method

OAuth App Setup

Step 1: Create a Dropbox App

  1. Go to the Dropbox App Console
  2. Click Create app
  3. Choose Scoped access and select the access type (Full Dropbox or App folder)
  4. Give your app a name
  5. Click Create app

Step 2: Configure OAuth Settings

  1. In your app settings, go to the Settings tab
  2. Under OAuth 2, add a redirect URI (e.g., http://localhost:3456/callback)
  3. Copy your App key (client ID) and App secret (client secret)

Step 3: Set Required Scopes

In the Permissions tab, enable the scopes your app needs:
  • files.metadata.read — Read file metadata
  • files.content.read — Read file content
  • files.content.write — Write files

Step 4: Store Credentials

pnpm corsair setup --plugin=dropbox client_id=your-app-key client_secret=your-app-secret

Step 5: Authorize

pnpm corsair auth --plugin=dropbox
This opens a browser window to complete the OAuth flow. Tokens are saved automatically.

Required Credentials Summary

CredentialRequired ForWhere to Find
App KeyOAuth flowDropbox App Console → Settings
App SecretOAuth flowDropbox App Console → Settings
For general information about how Corsair handles authentication, see Authentication.