Dropbox

Create a new Dropbox app

Go to the Dropbox App Console and complete the below steps:

1. Click Create App

2. Chooe the API - Scope Access

3. Choose App Folder Access

4. Click Create App

Add the re-direct URL for the Middle instance

Add https://YOURINSTANCENAME.middle.app/oauth-redirect-uri/ to the Redirect URIs and click Add.

Choose app scopes

Navigate to the Permissions tab and ensure file.contents.read is checked. Hit Submit at the bottom to save changes.

Retrieve the app key and secret

1. Navigate to the Settings tab.

2. Scroll to the App Key and App Secret area

3. Provide these credentials securely to the Middle team

Review your Dropbox folders

After this is set up, you should see a new folder in your Dropbox called Apps, and inside a folder for the new app you created.

Authenticate Dropbox in Middle

Once the API Key has been set up, you will be able to authenticate Dropbox from your Middle account.

1. By default, your authentication is connected to the root folder of the App Folder you've connected, meaning any files you drop in there would be selected. However, this integration is not recursive, meaning any folders within the App Folder will not be searched.

2. You can optionally add a subfolder as part of authenticating your Middle account. For folder content syncs, we would retrieve any files inside the folder you indicate.

   1. You will need to add the lower-case file path name for the folder.

   2. Ex: "/new folder" is the file path for the folder called "New Folder"

   3. You can come back and do this step later if needed - it's not required for initial authentication.

   
3. Hit Save

Launch the OAuth flow

You will then see a screen like this:

1. Ensure the correct API key is selected

2. Hit Save

3. Hit Launch OAuth Flow and authenticate with a user who either created or has developer access to the App created in the Dropbox App Console

   1. Sign in (if not already), and authorize the connection

   2. This should redirect you back to Middle with “oAuth Success”