## Dropbox integration

Integrating Dropbox with Frontegg allows your application to authenticate users via OAuth 2.0 and interact with their Dropbox accounts — uploading and downloading files, managing shared links, creating file requests, and accessing account information on their behalf.

Prerequisites
- A Dropbox account
- Access to the [Dropbox App Console](https://www.dropbox.com/developers/apps)


### Connect Dropbox

#### Step 1: Open the Dropbox App Console

Navigate to [dropbox.com/developers/apps](https://www.dropbox.com/developers/apps). Sign in with your Dropbox account if prompted. You will see your list of existing apps. Click **Create app**.

![Dropbox App Console](/assets/dropbox-1.7c2d358d889c680e358b3b034334fd23a2c7ab03a60820762d530f9ad78c1cb5.1ce25488.png)

#### Step 2: Choose the Scoped access API

On the **Create a new app on the DBX Platform** page, select **Scoped access** under step 1. This is the recommended API type that gives your app fine-grained control over the permissions it requests.

![Dropbox create app — choose API](/assets/dropbox-2.385a60de053dd053d44d0ff3b42772974388e78bd4c4b4bbd3b9543805ef7661.1ce25488.png)

#### Step 3: Configure app settings and create the app

Under step 2, select **Full Dropbox** to allow your app to access all files and folders in the user's Dropbox.

Under step 3, enter a name for your app (for example, `Frontegg Integration`), then click **Create app**.

![Dropbox create app — access type and name](/assets/dropbox-3.4937be5a6be5460db63d12b4fa228f7f948db194e9e37380819899cc6a073f39.1ce25488.png)

#### Step 4: Copy your App key

After the app is created, you land on the **Settings** tab. Find the **App key** field — this is your OAuth 2.0 Client ID. Copy it for use in the Frontegg portal.

![Dropbox App key](/assets/dropbox-4.92b916df3ad59ec2aad7a803953ad0a5904a6eeb4437dcbc068222465e29e99d.1ce25488.png)

#### Step 5: Copy your App secret

Next to the **App secret** field, click **Show**. Copy the revealed secret for use in the Frontegg portal.

Keep your credentials secure
Store the App secret immediately after copying it. Never share or commit it to version control.

![Dropbox App secret](/assets/dropbox-5.cdc9037f289f2454aa1ede8bc8a5cdaa92822f7e64c9853b8b194a61e6efbba2.1ce25488.png)

#### Step 6: Add redirect URIs

Scroll down to the **OAuth 2** section. In the **Redirect URIs** field, enter the following URIs one at a time and click **Add** after each:

- `https://YOUR_MCP_GATEWAY_URL/integration-callback`


![Dropbox redirect URI entry](/assets/dropbox-6.dc914bb9f4f1a65b2e69bba917ae0decbd415d3b8bd767e6ea0d32a5dcf467a5.1ce25488.png)

#### Step 7: Confirm redirect URIs saved

The redirect URI appears as a saved entry in the **Redirect URIs** section.

![Dropbox redirect URIs saved](/assets/dropbox-7.1e6d3b6fed6664a45098f7e692786ec9ce6698590eb40cc3d921f5b3e92b2bd5.1ce25488.png)

#### Step 8: Configure permissions

Click the **Permissions** tab. In the **Individual Scopes** section, enable the following scopes:

| Scope | Description |
|  --- | --- |
| `account_info.read` | View basic account information (username, email, country) |
| `files.metadata.read` | View information about files and folders |
| `files.content.write` | Upload, create, and delete files and folders |
| `files.content.read` | Download files and view folder contents |
| `sharing.write` | Manage sharing settings and shared links |
| `sharing.read` | View sharing settings and collaborators |
| `file_requests.write` | Create and manage file requests |
| `file_requests.read` | View file requests |
| `contacts.read` | View manually added Dropbox contacts |


Click **Submit** to save the permissions.

![Dropbox permissions configuration](/assets/dropbox-8.759f145eda22e0af25d313cf40aac39c94c6c09bca0abb54045814840f36ff30.1ce25488.png)

#### Step 9: Permissions saved

A confirmation banner appears: **Permissions change successful**. Your app is now fully configured.

![Dropbox permissions saved](/assets/dropbox-9.9575d3598eaad57c1cc04cbb16989f4955ddfb805296e80764e5f491f3ac9561.1ce25488.png)

### Configure the Frontegg portal

Once you have your **App key** and **App secret**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to **[ENVIRONMENT]** → **Integrations** → **Dropbox**.
2. Enter the **App key** in the **Client ID** field and the **App secret** in the **Client Secret** field.
3. Select the required **scopes**.
4. Click **Save**.


### Additional resources

- [Dropbox API documentation](https://www.dropbox.com/developers/documentation)
- [Dropbox App Console](https://www.dropbox.com/developers/apps)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)