# Retrieve Files from Dropbox

To retrieve files from Dropbox, create a new fetch task by following these steps. The connector runs fetch tasks automatically, based on the schedule that is configured in the configuration file.

NOTE: Before configuring a fetch task, you must create a Dropbox application to represent the connector and configure OAuth authentication. For more information, see Create a Dropbox Application and Configure OAuth Authentication.

To create a new Fetch Task

1. Stop the connector.
2. Open the configuration file in a text editor.

3. In the `[FetchTasks]` section of the configuration file, specify the number of fetch tasks using the `Number` parameter. If you are configuring the first fetch task, type `Number=1`. If one or more fetch tasks have already been configured, increase the value of the `Number` parameter by one (1). Below the `Number` parameter, specify the names of the fetch tasks, starting from zero (0). For example:

       [FetchTasks]
       Number=1
       0=MyTask

4. Below the `[FetchTasks]` section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

       [FetchTasks]
       Number=1
       0=MyTask

       [MyTask]

1. In the new section, ensure that you have set the parameters required to authenticate with Dropbox. The OAuth configuration tool (described in Configure OAuth Authentication) creates a file that contains these parameters, and you can include them in the connector's configuration file using the following syntax:

       [MyTask] < "oauth.cfg" [OAUTH]

   For more information about including parameters from another file, see Include an External Configuration File

2. In the new section, set the following parameters to specify the content to ingest:

   `RootFolderPath` | (Optional) The path in the Dropbox repository from which the connector retrieves data. The connector retrieves data from the specified folder and its subfolders.
   `PathCantHaveRegex` | (Optional) A regular expression to filter the documents that are ingested. Any document that has a path that matches the regular expression is ignored.
   `PathMustHaveRegex` | (Optional) A regular expression to filter the documents that are ingested. A document is ignored unless its path matches the regular expression.

   For a complete list of parameters that you can use to configure the Dropbox Connector, refer to the Dropbox Connector Reference.

3. (Optional) If you are running the connector behind a proxy server, set the following parameters:

   `ProxyHost` | The host name or IP address of the proxy server to use to access Dropbox.
   `ProxyPort` | The port of the proxy server to use to access Dropbox.
   `ProxyUsername` | The user name to use to authenticate with the proxy server.
   `ProxyPassword` | The password to use to authenticate with the proxy server.

4. Save and close the configuration file.

_FT_HTML5_bannerTitle.htm