# Creating an OAuth App for Dropbox

This guide will walk you through creating a Dropbox app, retrieving your **Client ID** and **Client Secret**, and adding them to your Apideck dashboard so you can sync files securely.

---

## Step 1: Create a Dropbox App

1. Access the Dropbox developers page at [https://www.dropbox.com/developers](https://www.dropbox.com/developers)

   ![Dropbox login page](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/login-page.png)

2. Click **Create App**  
3. Select the following options:
   - **API**: Choose **Scoped Access**
   - **Type of Access**: Select **Full Dropbox** (or **App Folder** if you only want access to a specific folder)
   - **Name your app**: Enter a unique name (e.g., *YourCompany-Integration*)
4. Click **Create App**

   ![Dropbox create app page](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/create-app.png)

---

## Step 2: Configure App Settings

1. On the **App Settings** page:
   - Copy the **App Key** (this will be your **Client ID**)
   - Copy the **App Secret** (this will be your **Client Secret**)

2. Under **OAuth 2**, add a redirect URI:
   - Use the callback URL:  
     ```
     https://unify.apideck.com/callback
     ```
   - Click **Add** to save it

3. Under **Permissions**, make sure to assign these scopes:

   - **account_info.read**  
     View basic information about your Dropbox account such as your username, email, and country  

   - **files.metadata.read**  
     View information about your Dropbox files and folders  

   - **files.metadata.write**  
     View and edit information about your Dropbox files and folders  

   - **files.content.read**  
     View content of your Dropbox files and folders  

   - **files.content.write**  
     Edit content of your Dropbox files and folders  

   ![Dropbox permissions tab](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/permissions-tab.png)

4. (Optional) Configure your domain name and logo on the **Branding** tab  

   ![Dropbox branding tab](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/branding-app.png)

---

## Step 3: Add Credentials to Your Apideck Dashboard

1. Log in to your [Apideck Dashboard](https://app.apideck.com/)  
2. Navigate to **Configuration** → **Dropbox**  
3. Enter the **Client ID** and **Client Secret** you copied earlier  
4. Save your changes  

   ![Apideck dashboard Dropbox integration](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/configure-connector.png)

---

## Step 4: Test the Connection

1. Go back to the **Dropbox integration** in your dashboard  
2. Click **Test Vault** to launch a Dropbox sign-in window  
3. You’ll be redirected to Dropbox to authorize the connection  
4. After granting access, you should see the integration status as **Connected**  

   ![Dropbox integration connected](https://res.cloudinary.com/apideck/image/upload/v1756198246/docs/connectors/dropbox/authorization-completed.png)

---

## 🎉 You’re Done!

Your Dropbox integration is now set up and ready to use through Apideck.
