How to Connect my Dropbox App with WordPress

This guide shows you how to create your own Dropbox app and link it to the Integrate Dropbox plugin. Using your own API credentials gives you a secure, private connection between your website and your Dropbox account, and lets you control the branding shown on the authorization screen.

Before You Begin

• The Integrate Dropbox plugin is installed and activated on your WordPress site.
• You have a Dropbox account you can sign in to.
• Your website uses a valid SSL certificate (HTTPS). For a local server, use the format http://localhost:xxxx.

Step 1: Open the Dropbox App Console

1. Go to the Dropbox App Console.
2. Sign in with your Dropbox account if you are not already logged in.
3. Click the Create app button.
4. Under Choose an API, select Scoped access.
5. Under Choose the type of access you need, select Full Dropbox – Access to all files and folders in a user’s Dropbox.
6. Enter a name for your app, then click Create app.

Step 2: Set the Required Permissions

For the plugin to browse and manage files from your WordPress dashboard, your app needs the right permissions.

1. Open the Permissions tab of your new app.
2. Check all of the individual scopes listed below.
3. Click the Submit button at the bottom of the page.

Important: Every scope below must be enabled. The plugin will not work correctly if any are missing.

Category	Required scopes
Account info	account_info.read
Files and folders	files.metadata.read files.metadata.write files.content.read files.content.write
Collaboration	sharing.read sharing.write file_requests.read file_requests.write contacts.read contacts.write

Step 3: Copy Your API Credentials and Add the Redirect URI

1. In your Dropbox app, open the Settings tab.
2. Copy your App Key and App Secret. You will need both in the next step.
3. In a new tab, open your WordPress dashboard and go to the Integrate Dropbox plugin’s login screen. Copy the Redirect URL shown there (use the first Ajax URL).
4. Back in the Dropbox App Console, paste that URL into the OAuth 2 Redirect URIs field.
5. Click the Add button.

Note: Dropbox requires a secure connection, so your site needs a valid SSL certificate. If you are working on a local server, use the http://localhost:xxxx format instead.

Step 4: Configure the Plugin in WordPress

1. Return to your WordPress dashboard and open the Integrate Dropbox login screen.
2. Paste your App Key and App Secret into their fields.
3. Confirm the Redirect URI has been added to your Dropbox app’s OAuth 2 settings (Step 4).
4. Click Sign In.
5. Log in to your Dropbox account and allow access when prompted.

That’s it. Your Dropbox account is now connected to your WordPress site.

Step 5: Customize Your Branding (Optional)

The branding details you set for your Dropbox app, such as the app name and icon, appear in the authorization window your users see when they connect. Update them in your app’s settings in the Dropbox App Console if you want a more professional, recognizable look.

Troubleshooting

• Redirect URI error: Make sure the URL in your Dropbox app matches the one shown in the plugin exactly, with no extra spaces or trailing characters, and that you clicked Add.
• Permission or scope errors: Re-open the Permissions tab, confirm every scope is checked, and click Submit. Then sign in to the plugin again.
• Invalid App Key or Secret: Copy the credentials again from the Dropbox app’s Settings tab and re-paste them carefully.
• Connection blocked: Check that your site is served over HTTPS with a valid SSL certificate.

Conclusion

You have now linked your own Dropbox app with the Integrate Dropbox plugin. With your own API credentials in place, your site can securely and efficiently work with your Dropbox files, all managed from the WordPress dashboard.