Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
| 1 | ## How do I set up custom OAuth credentials for Dropbox? |
| 2 | |
| 3 | Use your own Dropbox app when you want users to see your app's name on the consent screen and control the credentials yourself. |
| 4 | |
| 5 | ### Create the Dropbox app |
| 6 | |
| 7 | 1. Sign in to Dropbox and open the [Dropbox App Console](https://www.dropbox.com/developers/apps). |
| 8 | 2. Click **Create app** and choose **Scoped access**. |
| 9 | |
| 10 |  |
| 11 | |
| 12 |  |
| 13 | 3. Choose the access type: **App folder** (one dedicated folder) or **Full Dropbox** (all files). |
| 14 | 4. Enter an app name, such as `Composio-Dropbox`, and click **Create app**. |
| 15 | |
| 16 |  |
| 17 | 5. On the **Settings** tab, copy the **App key** (client ID) and **App secret** (client secret). |
| 18 | 6. In the **OAuth 2** section, under **Redirect URIs**, add `https://backend.composio.dev/api/v1/auth-apps/add`. It must exactly match the `oauth_redirect_uri` field in your Composio auth config, or Dropbox rejects the OAuth flow. |
| 19 | 7. On the **Permissions** tab, check the scopes your auth config will request (see below) and save. |
| 20 | |
| 21 |  |
| 22 | |
| 23 | ### Create the auth config in Composio |
| 24 | |
| 25 | 1. In the Composio dashboard, go to **Auth Configs**, click **Create Auth Config**, and select **Dropbox**. |
| 26 | |
| 27 |  |
| 28 | |
| 29 |  |
| 30 | 2. Set the authentication type to **OAuth2** and choose **Use your own developer authentication**. |
| 31 | |
| 32 |  |
| 33 | 3. Paste the **App key** as the **Client ID** and the **App secret** as the **Client Secret**, then click **Create Dropbox Auth Config**. |
| 34 | |
| 35 |  |
| 36 | 4. Click **Connect Account**, approve access in Dropbox, and confirm the account shows as **Active**. |
| 37 | |
| 38 | See [Custom auth configs](/docs/auth-configuration/custom-auth-configs) for the general flow. |
| 39 | |
| 40 | ### Scopes |
| 41 | |
| 42 | The default auth config requests `openid`, `email`, `profile`, and the read and write scopes for `account_info`, `files.metadata`, `files.content`, `file_requests`, `sharing`, and `contacts` (for example `files.content.read` and `files.content.write`). Enable the same permissions on the Dropbox app, or trim the auth config's **Scopes** field to the ones you enabled. |