> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corsair.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Credentials

> Step-by-step instructions for obtaining Dropbox OAuth credentials.

## Authentication Method

* **[`oauth_2`](/concepts/oauth)** - OAuth 2.0

## OAuth App Setup

### Step 1: Create a Dropbox App

1. Go to the [Dropbox App Console](https://www.dropbox.com/developers/apps)
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

```bash theme={null}
pnpm corsair setup --plugin=dropbox client_id=your-app-key client_secret=your-app-secret
```

### Step 5: Authorize

```bash theme={null}
pnpm corsair auth --plugin=dropbox
```

This opens a browser window to complete the OAuth flow. Tokens are saved automatically.

## Required Credentials Summary

| Credential | Required For | Where to Find                  |
| ---------- | ------------ | ------------------------------ |
| App Key    | OAuth flow   | Dropbox App Console → Settings |
| App Secret | OAuth flow   | Dropbox App Console → Settings |

For general information about how Corsair handles authentication, see [Authentication](/concepts/auth).