Creating a Connection

1. Connect your Dropbox from the dashboard.

   1. If using your personal account, select Personal Account
   2. If using a team account, select Team Account

2. Select an API key from the dropdown at the top. All documents created by the connection will be attributed to the selected API key.

3. Select the folder you want to sync. If you choose "My Dropbox" your entire dropbox will be synced.

4. Fill out any metadata you want to associate with the Dropbox data. You can use this to filter the data later. This is in JSON format. You can leave it blank, or you could set it to something like

5. json

   {
     "company": "acme"
   }

6. Select the import mode

7. Click "Create Connection" at the top right.

You will be taken back to the connectors page, and the system will schedule a sync process for you as soon as possible.

What is synced?

Everything in the dropbox folder you selected, including subfolders.

Metadata

Each Dropbox file includes the following metadata

Embedded

User vs Team account

When creating an embedded Dropbox connector, pass in "account_mode": "team" or "user" for config to choose a team or user account.

For example, the body can be

{
  "redirect_uri": "https://secure.ragie.ai/connectors",
  "partition": "dropboxfiles",
  "source_type": "dropbox",
  "metadata": {},
  "mode": "hi_res",
  "theme": "system",
  "page_limit": 1000,
  "config": {
    "account_mode": "team"
  }
}

Metadata

Each Dropbox file includes the following metadata