Dropbox signs users in with their Dropbox account. It suits products that also read or write files there, where one authorization covers both sign-in and access.

## Copy the redirect URI

In the [Authdog console](https://console.authdog.com), select the project and environment, open **Authentication > Providers**, find **Dropbox**, and click **Enable**. Copy the redirect URI shown in the form:

```url
https://identity.authdog.com/api/v1/callback/<connectionId>
```

## Create the application

1. Open the [Dropbox App Console](https://www.dropbox.com/developers/apps) and select **Create app**.
2. Choose **Scoped access**, then an access type — **App folder** is enough for sign-in.
3. Name the app and create it.
4. On the **Settings** tab, add the redirect URI from Authdog under **OAuth 2 Redirect URIs**.
5. On the **Permissions** tab, enable `account_info.read` and submit.
6. Copy the **App key** and **App secret** from **Settings**.

## Configure Authdog

| Field | Value |
| --- | --- |
| **Client ID** | The Dropbox **App key** |
| **Client Secret** | The Dropbox **App secret** |

Save, then toggle the connection **active**.

## What Dropbox returns

Authdog requests the `account_info.read` scope and reads the profile from `https://api.dropboxapi.com/2/users/get_current_account`.

The account endpoint returns the account ID, display name, email and its verified flag, and the account type.

Dropbox apps start in **Development** mode, capped at a small number of linked accounts. Apply for production status before opening sign-in to the public.

## Test it

1. Open your environment's hosted sign-in page, or link to `https://identity.authdog.com/api/v1/signin/<connectionId>`.
2. Select the Dropbox button and complete the flow.
3. Confirm the user appears under **Users** in the console with a Dropbox identity linked.

## Troubleshooting

| Symptom | Cause |
| --- | --- |
| `missing_scope` | The permission was enabled after the app was authorized — reauthorize |
| Development-mode cap reached | The app needs production approval from Dropbox |
| Redirect or callback URL error | The URI registered with the provider does not match Authdog's exactly |
| Works in one environment only | Each environment has its own `connectionId`, and so its own redirect URI to register |

## Related

| Read | To learn how to |
| --- | --- |
| [Connectors](/docs/connectors) | Set up any other social provider |