Dropbox uses Oauth 2.0 to connect. This means that you will need to create an app in the developer portal for Dropbox, and an authorized user for that app must complete the authentication in Middle.
1
Create a new Dropbox app
Go to the Dropbox App Console and complete the below steps:
Click Create App
Chooe the API - Scope Access
Choose App FolderAccess
Click Create App
App Folder Access allows the business to place all files the they want in the integration inside their app folder and keep the rest of their Dropbox separate
2
Add the re-direct URL for the Middle instance
Add https://YOURINSTANCENAME.middle.app/oauth-redirect-uri/ to the Redirect URIs and click Add.
If you have questions about your instance's name, please reach out to [email protected]
INTEGRATE customers should use the following: https://integrate.middle.app/oauth-redirect-uri/
3
Choose app scopes
Navigate to the Permissions tab and ensure file.contents.read is checked. Hit Submit at the bottom to save changes.
4
Retrieve the app key and secret
Navigate to the Settings tab.
Scroll to the App Key and App Secret area
Provide these credentials securely to the Middle team
We recommend using a service like OneTimeSecret to send secure credentials. There is no charge to use OneTimeSecret.
5
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.
6
Authenticate Dropbox in Middle
Once the API Key has been set up, you will be able to authenticate Dropbox from your Middle account.
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.
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.
You will need to add the lower-case file path name for the folder.
Ex: "/new folder" is the file path for the folder called "New Folder"
You can come back and do this step later if needed - it's not required for initial authentication.
Adding a new folder path via the Middle authentication
Hit Save
The new folder created by the Middle authnetication
7
Launch the OAuth flow
You will then see a screen like this:
Ensure the correct API key is selected
Hit Save
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
Sign in (if not already), and authorize the connection
This should redirect you back to Middle with “oAuth Success”
If you are not redirected to Middle please reach out to [email protected]
Setup a Dropbox folder for email attachment receiving
You can setup a unique email address for your Dropbox folder to receive emails and store attachments as files.
