# Dropbox

## Overview

The **Dropbox Connector** in **DBSync Cloud Workflow** enables secure, reliable, and automated integration between **Dropbox** - a popular cloud file storage and collaboration platform - and your enterprise systems such as CRM, ERP, databases, file services, and SaaS applications.

This connector lets you manage and synchronize files and folders in Dropbox as part of workflow automation. You can automate upload/download tasks, organize folders, or trigger actions based on file presence - all without manual intervention or custom code.

## Key Benefits

**For Business Users:**

* **Automated File Workflows:** Eliminate manual file transfers and streamline document processes.
* **Centralized File Access:** Share and distribute files across systems for better collaboration.
* **Reliable Data Flows:** Keep file operations consistent across teams and platforms.

**For Technical Teams:**

* **Secure OAuth Authentication:** Uses Dropbox OAuth 2.0 to authorize access safely.
* **Event-Ready Automation:** Combine file operations with workflow triggers to drive seamless automation.

## Supported Dropbox Operations

The Dropbox Connector supports the following operations within DBSync workflows after the Dropbox connector is configured:

* **Read:** Retrieve files from Dropbox folders.
* **Write:** Save or update files in Dropbox folders.

These operations are configured within the workflow using [Dropbox Action](https://docs.mydbsync.com/cloud-workflow/create-your-workflow/actions/storage/dropbox).

| Visit the Dropbox Action guide to learn how to set file paths, use dynamic filenames, apply regular expressions, and manage content. |
| ------------------------------------------------------------------------------------------------------------------------------------ |

## Prerequisites

Before configuring the Dropbox Connector, ensure the following prerequisites are met:

1. DBSync Access
   * A valid license for this connector and access to the DBSync Cloud Workflow platform.
2. Dropbox Account
   * A Dropbox account with access to the files and folders you want to integrate.
3. OAuth Authorization
   * Grant permissions via Dropbox OAuth when connecting the account.
4. File/Folder Permissions
   * The authenticated Dropbox account must have the necessary read/write permissions to perform the intended operations for the target folder.

## Connector Configuration

Each Dropbox connector instance represents a connection to a single Dropbox account or workspace. To connect multiple Dropbox accounts, create separate connector configurations.

#### Authentication (OAuth 2.0)

The Dropbox Connector uses **OAuth 2.0** for secure authentication.

{% hint style="info" %}
Note: OAuth ensures that DBSync never stores your Dropbox password and manages token refresh automatically.
{% endhint %}

## Quick Setup Guide

1. Login to DBSync Cloud Workflow
   * Use your DBSync credentials to access the platform.
2. Add the Dropbox Connector
   * Navigate to the connectors list in the Apps pane and select **Dropbox**.
3. Initiate Connection
   * In the Dropbox Connector configuration page, click **Login to Dropbox (OAuth)** to open the OAuth authorization flow.

     <figure><img src="https://1036205596-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fv9avy716UiAsS24zOznZ%2Fuploads%2FoCOwqDqHjNuD7dNvAlXd%2Funknown.png?alt=media&#x26;token=ed268fe7-b0e5-4e90-ae29-7b107f1828cc" alt=""><figcaption></figcaption></figure>
4. Authorize Access Log in to Dropbox and grant DBSync the requested permissions.
5. Verify Connection Upon successful authorization, your Dropbox account name will be displayed - indicating that the connector is active.

Once configured, Dropbox operations will be available within workflows.

{% hint style="info" %}
Note: DBSync securely stores the OAuth tokens and uses them for subsequent operations.
{% endhint %}

## Common Use Cases

The Dropbox connector supports a variety of real-world automation scenarios. For example,

**Scenario:** Exporting daily sales data from Salesforce into a Dropbox folder as a CSV file

* **Workflow Steps:**
  * **Salesforce Query Action:**
    * Pull records from Salesforce (For example, `SELECT Name, Amount FROM Opportunity`).
  * **Transform Data (Optional):**
    * Format or filter your records into CSV format.
  * **Dropbox Write Action:**
    * File Path: Use a dynamic name like *daily\_sales{TodayDate}.csv*
    * Content: Map the transformed data from Salesforce

This enables automatic daily backups of Salesforce data into your Dropbox folder. This helps for audits and team reporting.

## Summary

The **Dropbox Connector** in **DBSync Cloud Workflow** provides a secure and automated way to integrate cloud file storage into your enterprise workflows. It supports essential file operations and enables teams to automate backups, share and sync files across systems, and streamline document-centric processes - all without custom scripts or manual intervention.

## Frequently Asked Questions (FAQ)

<details>

<summary>Can I connect multiple Dropbox accounts?</summary>

Yes, create separate connector instances for each Dropbox account you want to integrate.

</details>

<details>

<summary>Can I use the Dropbox Connector for both reading and writing files?</summary>

Yes, the Dropbox Connector supports both reading and writing operations. You can configure it to retrieve files from Dropbox or upload files to Dropbox.

</details>

<details>

<summary>How do I handle file name conflicts when uploading files?</summary>

You can set the "If File Name Exists" property to either Skip or Override. This allows you to choose whether to skip uploading a file if it already exists or to override the existing file.

</details>

<details>

<summary>What is the maximum batch size for file uploads?</summary>

The maximum batch size for file uploads is 1000. You can select the batch size based on your needs, such as 10, 50, 100, or 1000.

</details>

<details>

<summary>Can I use regular expressions for file paths?</summary>

Yes, you can use regular expressions to query a pattern of files in Dropbox. This is useful for dynamically selecting files based on specific patterns.

</details>

<details>

<summary>Is the authorization secure?</summary>

Yes, the connector uses OAuth 2.0 and securely stores tokens. Dropbox credentials are never stored by DBSync.

</details>

<details>

<summary>Can I access shared or team Dropbox folders?</summary>

Yes, if the authenticated account has access to those folders, the connector can operate on them.

</details>

<details>

<summary>Can I upload large files?</summary>

Yes, the connector supports large file uploads within Dropbox API limits.

</details>

<details>

<summary>Can I trigger workflows based on file changes?</summary>

Workflows can be scheduled or configured to check for file usage; direct push triggers are typically implemented via external event services.

</details>

### Useful links:

[Dropbox Actions](https://docs.mydbsync.com/cloud-workflow/create-your-workflow/actions/storage/dropbox): Use the Dropbox Connector together with Dropbox Actions to make the most of your integration.

[CSV Action](https://docs.mydbsync.com/cloud-workflow/create-your-workflow/actions/storage/csv): Use the CSV Action alongside the Dropbox Action to transform data into CSV format.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mydbsync.com/cloud-workflow/2026_connectors_new/dropbox.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
