---
title: Dropbox File Integration Setup
description: Dropbox, Files, Integration, setup
---

[Skip to content](https://help.myhubintranet.com/dropbox-file-integration-setup#main-content)

![logo-large-square-1](https://help.myhubintranet.com/hs-fs/hubfs/logo-large-square-1.png?width=120&height=120&name=logo-large-square-1.png)

Open main navigation

Close main navigation

 How can we help you?

- There are no suggestions because the search field is empty.

1. [MyHub Knowledge Base](https://help.myhubintranet.com/?hsLang=en-us)
2. [Settings, General & Other](https://help.myhubintranet.com/settings-general-other?hsLang=en-us)

# 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](https://www.dropbox.com/developers/apps) 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](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 |

### ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-18-2026-08-19-56-3106-PM.png?width=670&height=286&name=image-png-Jun-18-2026-08-19-56-3106-PM.png)

### 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:

![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-18-2026-09-04-32-4276-PM.png?width=1093&height=209&name=image-png-Jun-18-2026-09-04-32-4276-PM.png)

 

> **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

 

![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-18-2026-08-41-31-9498-PM.png?width=670&height=401&name=image-png-Jun-18-2026-08-41-31-9498-PM.png)

 

> **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 
     1. ![](https://help.myhubintranet.com/hs-fs/hubfs/image-png-Jun-18-2026-08-54-56-7994-PM.png?width=937&height=300&name=image-png-Jun-18-2026-08-54-56-7994-PM.png)
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.

- [Contacting MyHub](https://help.myhubintranet.com/contacting-myhub?hsLang=en-us)
- [Modules](https://help.myhubintranet.com/modules?hsLang=en-us)
- [MyHub Security](https://help.myhubintranet.com/myhub-security?hsLang=en-us)
- [User Management & Permissions](https://help.myhubintranet.com/user-management-permissions?hsLang=en-us)
- [Learning Management System](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#main-content)

    - [Overview Video](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#overview-video)
    - [Settings & Configuration](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#settings-configuration)
    - [Content & Library](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#content-library)
    - [Pathways](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#pathways)
    - [Roadmaps](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#roadmaps)
    - [Gamification & Badges](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#gamification-badges)
    - [Learnings](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#learnings)
    - [Events](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#events)
    - [Learning Management Forms](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#learning-management-forms)
    - [Certificate](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#certificate)
    - [Announcements](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#announcements)
    - [Continuing Professional Development (CPD)](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#continuing-professional-development-cpd)
    - [Reporting & Dashboards](https://help.myhubintranet.com/learning-management-system?hsLang=en-us#reporting-dashboards)
- [Settings, General & Other](https://help.myhubintranet.com/settings-general-other?hsLang=en-us)
- [Single Sign On Options](https://help.myhubintranet.com/single-sign-on-options?hsLang=en-us)
- [Performance & Growth Module](https://help.myhubintranet.com/performance-growth-module?hsLang=en-us)

[![blank-logo-1](https://help.myhubintranet.com/hs-fs/hubfs/blank-logo-1.png?width=10&height=10&name=blank-logo-1.png "blank-logo-1")](https://www.myhubintranet.com)

© [MyHub Intranet Software](https://www.myhubintranet.com/) 2025.