Skip to main content
This guide shows you how to register your own app with Dropbox to obtain your OAuth credentials (client id & secret). These are required to let your users grant your app access to their Dropbox account.

​
Creating a Dropbox App

1

Register for a Dropbox developer account

If you don’t already have one, sign up for a Dropbox developer account.
2

Create a new app

Go to the Dropbox App Console and click “Create app”.Choose your API type and access level:
  • Scoped access: Recommended for most applications, provides granular permission control
  • Full Dropbox access or App folder access: Choose based on your app’s needs
3

Configure OAuth settings

In your app’s settings:
  1. Add your OAuth Redirect URI: https://api.nango.dev/oauth/callback
  2. Note your App key (Client ID) and App secret (Client Secret)
4

Configure permissions

Navigate to the Permissions tab in your app console.Select the appropriate scopes for your application. Common scopes include:
  • files.metadata.read - Read file and folder metadata
  • files.metadata.write - Create, edit, and delete files and folders
  • files.content.read - Read file content
  • files.content.write - Upload and modify file content
Changes to permissions require users to re-authorize your app to grant the new scopes.
5

Add credentials to Nango

In Nango:
  1. Go to the Integrations page
  2. Find and select Dropbox
  3. Enter your App key as the Client ID
  4. Enter your App secret as the Client Secret
  5. Add any required scopes in the configuration
  6. Click Save

​
Access Requirements

Note the following requirements for Dropbox apps:
RequirementStatusNotes
Paid developer accountUnknownCheck current requirements with Dropbox
Paid test accountUnknownMay be required for testing
PartnershipUnknownMay be needed for production access
App reviewUnknownMay be required before production launch
Security auditUnknownMay be required for certain access levels
Check Dropbox’s developer documentation for the most up-to-date requirements and guidelines.
For more details on Dropbox’s OAuth implementation, see Dropbox’s OAuth documentation.