Dropbox – Configuration Guide

Service ID: dropbox

Dropbox is a modern workspace designed to reduce busywork-so you can focus on the things that matter. Sign in and put your creative energy to work.

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

    Dropbox login page

  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


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

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

    Dropbox branding tab


Step 3: Enable Additional Users

By default, a newly created Dropbox app is in Development status and can only be linked to the account that created it (the app's settings page shows Development users: Only you). To allow other Dropbox accounts to connect through Apideck, you must raise this limit:

  1. On the app's Settings page, find the Development users row

  2. Click Enable additional users — this raises the development limit to 500 users

    Dropbox enable additional users

⚠️ Apply for production before going live. A development-status app can link a maximum of 500 users, and once it links 50 users, Dropbox gives you a two-week window to apply for and receive production approval — after which the app can no longer link new users (existing connections keep working). To avoid disruption, click Apply for production on the app's settings page before rolling the connection out to real users. You can monitor your current linked-user count under the app's Analytics tab; Dropbox does not expose this count via API.


Step 4: Add Credentials to Your Apideck Dashboard

  1. Log in to your Apideck Dashboard

  2. Navigate to ConfigurationDropbox

  3. Enter the Client ID and Client Secret you copied earlier

  4. Save your changes

    Apideck dashboard Dropbox integration


Step 5: 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


🎉 You’re Done!

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