> For the complete documentation index, see [llms.txt](https://docs.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.couchdrop.io/storage/integrations/dropbox.md).

# Dropbox

Learn how to connect Couchdrop to Dropbox

## Overview

Couchdrop can connect directly to Dropbox Personal or Dropbox Business and make that storage available through Couchdrop.

Once connected, you can use Dropbox with Couchdrop file transfer and workflow features while keeping files in your existing Dropbox account.

### Dropbox Personal

Use **Dropbox Personal** when connecting an individual Dropbox account.

Couchdrop requests access to the Dropbox APIs so it can list folder contents and upload, download, delete, and make changes to content stored in Dropbox.

### Dropbox Team

Use **Dropbox Team** when connecting a Dropbox Business account.

The configuration is similar to Dropbox Personal, with an additional **Administrator Account** field used when connecting the Dropbox team.

## How to connect Dropbox

{% hint style="warning" %}

#### Before you start

To connect Dropbox, you will need:

* A licensed Dropbox account
* Access to an Administrator account if you are connecting Dropbox Business
  {% endhint %}

{% stepper %}
{% step %}

### Add a new storage connection

In Couchdrop, add a new storage connection.

Select **Dropbox Personal** if you are connecting an individual Dropbox account, or **Dropbox Team** if you are connecting Dropbox Business.
{% endstep %}

{% step %}

### Configure Dropbox

Enter a **Name for this integration** and select the **Couchdrop folder path** where the connection will appear.

For **Dropbox Team**, enter the **Administrator Account** that Couchdrop will use for the connection.

Select **Authorize Dropbox** and complete the Dropbox authorization process to grant Couchdrop access to the account.

Select **Save and Test** to verify the Dropbox connection.
{% endstep %}

{% step %}

### Map your Dropbox folder

After the connection has been tested, you can select a Dropbox user or specific folder to map into Couchdrop.

Leaving the folder blank allows Couchdrop to map the Dropbox connection without restricting it to a specific subfolder.
{% endstep %}

{% step %}

### Save and use your Dropbox integration

Optionally, configure **Transfer Shield** to surface or block unexpected, non-compliant, or malicious files uploaded through this connection.

When the configuration is complete, save the integration.
{% endstep %}
{% endstepper %}

## Frequently asked questions

<details>

<summary>Can Couchdrop connect to Dropbox Personal and Dropbox Business?</summary>

Yes. Couchdrop provides separate **Dropbox Personal** and **Dropbox Team** connection types.

</details>

<details>

<summary>Do I need a Dropbox administrator account?</summary>

An Administrator account is required when connecting Dropbox Business through **Dropbox Team**. It is not required for a Dropbox Personal connection.

</details>

<details>

<summary>Do I need to select a Dropbox folder?</summary>

No. Selecting a folder is optional.

After the connection has been saved and tested, you can select a specific folder to limit the mapped location or leave the folder blank so Couchdrop can map the Dropbox connection directly.

</details>

<details>

<summary>What access does Couchdrop require?</summary>

Couchdrop requires authorized access to the Dropbox APIs so it can list folder contents and upload, download, delete, and make changes to content stored in Dropbox.

Couchdrop states that this access is used in accordance with its [privacy policy](https://couchdrop.io/legal/privacy-policy) and [terms of service](https://couchdrop.io/legal/terms-of-service-policy).

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.couchdrop.io/storage/integrations/dropbox.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.