Saltar al contenido principal

Dropbox File Connector

Version 2


Important: When referencing this page outside of Knowledge Base, use this link:


Dropbox is a personal cloud storage service frequently used for file sharing and collaboration. You can use Domo's Dropbox connector to compile reports about account information, metadata, or revisions, or to retrieve files and folders based on a search. To learn more about the Dropbox API, go to (

You connect to your Dropbox account in the Data Center. This topic discusses the fields and menus that are specific to the Dropbox connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in Adding a DataSet Using a Data Connector.


To connect to your Dropbox account and create a DataSet, you must have the following:

  • The email address you enter to access your Dropbox account.

  • Your Dropbox password.

Connecting to Your Dropbox Account

This section enumerates the options in the Credentials and Details panes in the Dropbox Connector page. The components of the other panes in this page, Scheduling and Name & Describe Your DataSet, are universal across most connector types and are discussed in greater length in Adding a DataSet Using a Data Connector.

Credentials Pane

The Domo Dropbox connector uses OAuth to connect. Click Connect (or select Add Account if you have existing Dropbox accounts in Domo) to open the Dropbox OAuth screen where you can enter the email address associated with your Dropbox account and your Dropbox password. Once you have entered valid Dropbox credentials, you can use the same account any time you go to create a new Dropbox DataSet. You can manage connector accounts in the Accounts tab in the Data Center. For more information about this tab, see Managing User Accounts for Connectors.

Note: If you are already logged into Dropbox when you connect in Domo, you are authenticated automatically when you click Add account. If you want to connect to an account that is different from the one you are logged into, you must first log out of Dropbox.

Details Pane

This pane contains a primary Reports menu, along with various other menus which may or may not appear depending on the report type you select.




Select the Dropbox report you want to run. The following reports are available:

Account Information Returns information about the authenticated user's account.

Returns metadata for the specified file or folder.

Enter the path for the Dropbox file you want to retrieve information for.


Returns metadata for all available revisions of a file, including the current revision.


Returns metadata for all files and folders whose filename contains the given search string as a substring.

File Path Enter the path for the Dropbox file you want to retrieve information for.
Search Text Enter a search string to return files and folders based on that string. Files and folders are returned only if they contain all words in the search string.

Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see Adding a DataSet Using a Data Connector.