Skip to content
  • There are no suggestions because the search field is empty.

Dropbox File Integration Setup

 What This Guide Covers

This guide walks a portal administrator through setting up Dropbox as a file provider in the Display & Share Files module. Once configured, content editors and administrators can browse Dropbox folders and select files to display on your intranet pages.

You create and own the Dropbox app yourself.
The Display & Share Files module does not use a shared or published Dropbox app. Instead, each organisation creates their own private Dropbox app in their own Dropbox account. The app keys belong to you — not to MyHub. If you ever want to stop using Dropbox with MyHub, or if you leave the platform entirely, simply delete your app in the Dropbox App Console and all access is immediately revoked. You are never dependent on MyHub to connect or disconnect your Dropbox account.

Before You Begin

You will need:

  • A Dropbox account with access to the files you want to display (a Dropbox Business account is recommended for team use)
  • Access to the Dropbox App Console to create an integration app
  • A MyHub administrator account to enter the credentials into the Display & Share Files module or in Site Settings - File Share Settings

Step 1 — Create a Dropbox App

  1. Go to https://www.dropbox.com/developers/apps
  2. Sign in with the Dropbox account that owns the files
  3. Click Create app
  4. Configure the app:
    • Choose an API: Select Scoped access
    • Choose the type of access: Select Full Dropbox
      (Select "App folder" only if you want to restrict the module to a single folder. The module will then only be able to browse that folder)
    • Name your app: Enter any name you like, e.g. MyHub FileShare. This name is only visible to you in your Dropbox developer console. It is not shown to end users and does not affect functionality.
  5. Click Create app

After creation, you will land on the app's Settings page.

You do not need to publish this app.
Dropbox apps start in "development" status. You never need to submit the app to Dropbox for review or make it publicly listed. Your app remains private to your Dropbox account, indefinitely. There is no Dropbox requirement or deadline to publish it.

Step 2 — Note the App Credentials and Configure Redirect URI

Everything in this step is on the app's Settings tab.

App Credentials

Value Field name Where to find it
App key appKey Under "App key" on the Settings tab
App secret appSecret Under "App secret" — click Show to reveal it

OAuth 2 — Redirect URIs

Scroll down to the OAuth 2 section. You will see a Redirect URIs field with an input box and an Add button.

Add the callback URL below:

https://filesprovider.myhubintranet.com/DesktopModules/MyHubModulesFileShare/API/FileShare/auth/callback

Click Add after entering the URI.

It should look like the below:

 

Why this matters: When a user clicks Authenticate in MyHub, Dropbox redirects the browser back to this URI with an authorization code. If the URI is not registered here exactly as entered, Dropbox will block the redirect and the authentication will fail with a "redirect_uri mismatch" error.

Step 3 — Configure Permissions (Scopes)

  1. Click the Permissions tab in your app settings
  2. Locate the Files and folders section and tick:
    • files.content.read — View content of your Dropbox files and folders
  3. Locate the Collaboration section and tick:
    • sharing.write — View and manage your Dropbox sharing settings and collaborators
  4. Click Submit at the bottom of the Permissions tab

 

 

Greyed-out checkboxes are auto-granted — no action needed. Some scopes appear pre-selected and greyed out (account_info.read, files.metadata.read, sharing.read). These are automatically included by Dropbox and cannot be unchecked. You do not need to do anything for them.

Important: If you change scopes after authenticating, you must click the Authenticate button again in MyHub to issue a new token with the updated scopes.

 

Step 4 — Configure the Provider in MyHub

  1. Navigate to the page containing the Display & Share Files module or Site Settings - File Share Settings
  2. In the provider selection screen, choose Dropbox
  3. If no Dropbox provider has been configured yet, you will be shown the credential form
  4. Fill in the fields from the App Key and App Secret from Dropbox
  5. Click the Activate button — a Dropbox sign-in window will open; sign in and click Allow

Required Scopes Summary

Scope How it is granted Purpose
account_info.read Auto-included (greyed) Basic account identity
files.metadata.read Auto-included (greyed) Browsing folders and listing files
files.content.read Manually tick this Generating temporary links for file embedding
sharing.read Auto-included (greyed) Reading existing shared links (fallback embedding)
sharing.write Manually tick this Creating shared links when temporary links are unavailable

Revoking Access

Because you own the Dropbox app, you can revoke MyHub's access at any time without involving MyHub support:

  • Delete the app entirely: Go to the Dropbox App Console, open your app, scroll to the bottom of the Settings tab and click Delete app. This immediately invalidates all tokens — MyHub loses access instantly.
  • Revoke without deleting: In your personal Dropbox account settings, go to Settings > Connected apps and revoke the app from there. Tokens are invalidated but the app registration stays in the Developer Console for future use.

Troubleshooting

Authentication fails with "redirect_uri mismatch" or "invalid redirect_uri" - The URI that MyHub sent to Dropbox during the auth flow does not exactly match any URI registered in the app's Settings tab. Go back to the Dropbox App Console > Settings > OAuth 2 > Redirect URIs and confirm the production URI is listed exactly as: https://filesprovider.myhubintranet.com/DesktopModules/MyHubModulesFileShare/API/FileShare/auth/callback - Check for trailing slashes, http vs https, or domain typos, as Dropbox matches the URI character-for-character.

Files appear in the picker but don't display on the page - Check that files.content.read is enabled in the app's Permissions tab in the Dropbox App Console. If you changed permissions after authenticating, click the Authenticate button again in MyHub.