Establish connectivity to Dropbox Paper

This article describes how to connect to Dropbox Paper server in order to load data into Datasets and Reports in Metric Insights.


  • Before using the Dropbox Paper plugin, you must have registered an account with Dropbox
  • Since the plugin uses security token from your account, get the Dropbox security Token

General instructions on setting up data sources based on plugins can be found here

1. Access Admin > Data Sources

At the bottom of the screen click [+ New Data Source].

The Select the Type of New Data Source pop-up opens.

2. "Select the Type of New Data Source" pop-up opens

  1. Select "Other" and choose "Dropbox Paper" from the drop-down list
  2. Next step

3. Provide the Required Parameters

  1. Data Source Name is defaulted but you may modify it
  2. Token: enter the security token provided by Dropbox
  3. Save your entries
  4. Test Connection

If your connection is successful, you may move on to Advanced settings.

3.1. How to obtain a security Token in Dropbox?

3.1.1. DBX Platform developer portal > My apps

  1. Access DBX Platform Developer Portal
  2. On the Homepage, click [My apps]
  3. Click the name of your Application
    • If you do not have an application yet, create one with the [Create app] button

You will be redirected to the App's page on the App Console.

3.1.2. Dropbox App Console > Generate Token

On your App's page, find the Generate button:

  • Click [Generate] to get the Token

4. Advanced Configuration

  1. Use Remote Data Collector: is set to "no" by default
    • If required, switch to "yes" and add a Remote Data Collector by clicking [+New Remote Collector].
  2. Generate Object List: This setting influences options available in the Dropbox Paper Objects tab:
    • automatically: all Objects are going to be fetched by the system
    • manually: Objects may be added one-by-one or via CSV file
  3. Object List Refresh Trigger: from the dropdown, select the Trigger that will be used to fetch data from Dropbox Paper Objects
  4. Optionally, state the maximum number of concurrent Threads to utilize during data and/or image fetch to be used in background processing when the system updates Documents for this Data Source:
    •  If you do not specify any value for this setting, batch data collection processing will be single-threaded

5. Obtain a list of External Reports

  1. Go to Dropbox Paper Objects tab
  2. To obtain a list of Dropbox Paper Documents, click the [Refresh list] button

6. Other Settings

  1. You can create Elements directly from the respective tab
  2. Click Permissions to assign permissions to the Data Source to Groups or Power Users