Dropbox Filesystem Connector

Dropbox is a cloud-based file hosting service that offers cloud file hosting and other services.

Generating a Dropbox API Key

To connect to Dropbox, you'll first need to generate a unique Dropbox API key:

1. Navigate to the Dropbox App Console and click Create app
2. Complete the form, making sure to choose the following options:

• API: Scoped Access
• Access Type:
  • App Folder will restrict Unstract to only a single folder and its subdirectories.
  • Full Dropbox will allow Unstract to read the contents of all folders

3. Name your app, then choose Create app
4. In your new app's Settings page, click the Permissions tab
5. Choose the following scopes, making sure to Submit your changes

• files.metadata.read

• files.content.read

  

6. After saving your changes, return to the Settings tab.

7. Finally, press the Generate button located in the Generated Access Token section of OAuth2

8. Copy the generated key to your clipboard. It should look like this:

   sl.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Note: The Dropbox access token must be re-generated any time there is a change to the app's Scope.

Connecting to Dropbox

1. In the Configure Connector screen, choose Dropbox
2. Rename your connector, if desired, then paste your Dropbox API Key in the Access Token field
3. Click Test Connection
4. Once the test is successful, Submit your changes.

Connector Options

The Configuration panel offers a few options:

• Folder to Process: The top-level directory Unstract should have access to.
• File types to process: Limit Unstract to processing certain file types only.
• Max files to process: The number of files Unstract should process in each batch.

Testing the connection

After submitting your Access Token, click the File System tab.

If the configuration is correct, you should see a directory of your connected Dropbox folders.

Need a hand?

Talk to us on slack! We're here to help :)