> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unleashx.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Dropbox
> Let your UnleashX agent browse, search, upload, share and version files in Dropbox.
# Dropbox
> **In one line:** Connect Dropbox so your UnleashX agent can find a file, put a new one where it belongs, share it with a link, restore last week's version, and start a workflow the moment something lands in a folder.
| | |
| ------------------ | --------------------------------------------------------------------------------------------- |
| **Category** | Storage |
| **Authentication** | OAuth (Dropbox sign-in) |
| **Setup time** | \~2 minutes |
| **Difficulty** | Easy |
| **Best for** | Teams whose documents live in Dropbox and who want an agent filing, fetching and sharing them |
## 1. Overview
Dropbox is cloud file storage. Everything is addressed by **path** (`/Clients/Acme/contract.pdf`), files keep a revision history, and access is granted with shared links or by inviting members.
Once connected to UnleashX, your agent can list and search the account, read metadata, create folders, move, copy and delete, upload from a URL, download small files inline, fetch thumbnails and temporary download links, list and restore revisions, create and revoke shared links, invite people to files, share folders, and report the account and its storage usage.
One trigger fires when files are added or changed in a folder.
Connecting Dropbox to UnleashX means the agent can treat your file store as part of a workflow: a signed contract arrives, gets filed under the right client, and a shareable link goes back to the team.
## 2. What you'll need
* A **Dropbox account** (personal or Business).
* Permission to authorize UnleashX against it.
* An UnleashX agent where you'll add the connector.
On a Dropbox Business team, an admin may need to allow third-party apps before authorization will succeed.
## 3. Get your credentials
Dropbox uses **OAuth 2.0**. There's no key to create or paste — UnleashX sends you to Dropbox, you sign in once, and Dropbox issues a token that UnleashX refreshes automatically.
In your agent's **Data Connectors**, find **Dropbox** and click **Connect** (see Section 4).
Choose the Dropbox account whose files the agent should work with.
Approve the requested permissions and you'll be returned to UnleashX.
There's no key to copy. Access can be revoked at any time from [Dropbox → Settings → Connected apps](https://www.dropbox.com/account/connected_apps).
### Access this grants UnleashX
| Access | Why UnleashX needs it |
| ----------------------- | ------------------------------------------------------------------------ |
| Read files and folders | List, search, and read metadata |
| Write files and folders | Create folders, upload, move, copy, delete |
| File revisions | List previous revisions and restore one |
| Sharing | Create, list and revoke shared links; invite file members; share folders |
| Account info | Report the connected account and its storage usage |
If a call fails with a scope error, ticking the scope in the Dropbox App Console **isn't enough on its own** — you also have to reconnect. A token already issued doesn't gain scopes retroactively.
## 4. Connect on UnleashX
Sign in at [https://www.tryunleashx.com](https://www.tryunleashx.com) and open the agent you want to connect.
In the agent, go to **Data Connectors** and find **Dropbox**.
Click **Connect**, sign in with Dropbox, and approve access.
You'll return to UnleashX and the connector will show a **Connected** badge.
### Use Dropbox in a Workflow
Once connected, you can add **Dropbox** to any automation from the **Workflows** builder. Its trigger and tools appear in the Apps panel, marked with an **MCP** badge.
Open **Workflows → New Workflow**. On the canvas, click the **+** below a node, then open the **Apps** tab in the **Paths** panel and select **Dropbox** — its **Actions** are listed underneath. Use the search box if you have many connectors.
Choose the action from **Select Action**, then pick the connected account under **Select Account** — or click **Add Account** to authorize one now.
Required fields are marked with a red asterisk (\*). Most tools take a **path** like `/Clients/Acme/contract.pdf`.
Click **Save**. Use **Test** to verify the step, then toggle **Publish** when the workflow is ready.
The steps are the same for every connector. For the full workflow builder guide, see [Using MCP in Workflows](/mcp/workflows).
## 5. Available tools
Paths start at the account root and use forward slashes — `/Invoices/2026/march.pdf`. An empty path means the root folder.
Names match the **Workflows** Apps panel, which lists them alphabetically; they're grouped here by what they do. The **Tool ID** is what the agent calls behind the scenes.
**Browsing and organising**
| Tool | Tool ID | What it does | Required | Changes data? |
| -------------------- | ------------------------------ | ----------------------------------------------------------------- | ---------------------- | ------------- |
| List Folder | `dropbox_list_folder` | Lists files and folders at a path | — | No |
| List Folder Continue | `dropbox_list_folder_continue` | Fetches the next page using the cursor from List Folder | `cursor` | No |
| Get Metadata | `dropbox_get_metadata` | Size, rev, modified time and id for one file or folder | `path` | No |
| Search | `dropbox_search` | Searches the account by name or content | `query` | No |
| Create Folder | `dropbox_create_folder` | Creates a folder | `path` | ✏️ Yes |
| Move | `dropbox_move` | Moves or renames a file or folder | `from_path`, `to_path` | ✏️ Yes |
| Copy | `dropbox_copy` | Copies a file or folder | `from_path`, `to_path` | ✏️ Yes |
| Delete | `dropbox_delete` | Deletes a file or folder — it goes to the trash and is restorable | `path` | ⚠️ Yes |
**Getting files in and out**
| Tool | Tool ID | What it does | Required | Changes data? |
| ------------------ | ---------------------------- | ---------------------------------------------------------------------------- | -------------------- | ------------- |
| Upload | `dropbox_upload` | Uploads to Dropbox from a publicly reachable URL | `path`, `source_url` | ✏️ Yes |
| Save URL | `dropbox_save_url` | Has Dropbox fetch a URL server-side and save it, with no size limit | `path`, `url` | ✏️ Yes |
| Download | `dropbox_download` | Returns a small file's contents inline, as text and base64 — capped at 10 MB | `path` | No |
| Get Temporary Link | `dropbox_get_temporary_link` | A direct download URL, valid for four hours | `path` | No |
| Get Thumbnail | `dropbox_get_thumbnail` | A base64 JPEG thumbnail of an image or document | `path` | No |
For anything large, use **Save URL** — Dropbox pulls the bytes itself and nothing is size-capped. **Upload** and **Download** move the bytes through the request, which is why Download stops at 10 MB.
**Versions**
| Tool | Tool ID | What it does | Required | Changes data? |
| -------------- | ------------------------ | -------------------------------------- | ------------- | ------------- |
| List Revisions | `dropbox_list_revisions` | Previous revisions of a file | `path` | No |
| Restore | `dropbox_restore` | Restores a file to an earlier revision | `path`, `rev` | ⚠️ Yes |
**Sharing**
| Tool | Tool ID | What it does | Required | Changes data? |
| ------------------------ | ---------------------------------- | -------------------------------------------- | ------------------- | ------------- |
| Create Shared Link | `dropbox_create_shared_link` | Creates a shareable link to a file or folder | `path` | ✏️ Yes |
| List Shared Links | `dropbox_list_shared_links` | Lists existing shared links | — | No |
| Get Shared Link Metadata | `dropbox_get_shared_link_metadata` | Looks up what a shared link points at | `url` | No |
| Revoke Shared Link | `dropbox_revoke_shared_link` | Revokes a link so it stops working | `url` | ⚠️ Yes |
| Add File Member | `dropbox_add_file_member` | Invites people to a file by email | `file_id`, `emails` | ✏️ Yes |
| List File Members | `dropbox_list_file_members` | Lists who has access to a file | `file_id` | No |
| Share Folder | `dropbox_share_folder` | Turns a folder into a shared folder | `path` | ✏️ Yes |
| List Shared Folders | `dropbox_list_shared_folders` | Lists shared folders this account belongs to | — | No |
**Account**
| Tool | Tool ID | What it does | Required | Changes data? |
| ------------------- | ----------------------------- | --------------------------------------------------- | -------- | ------------- |
| Get Current Account | `dropbox_get_current_account` | Name, email and account id of the connected account | — | No |
| Get Space Usage | `dropbox_get_space_usage` | Storage used and the account's quota | — | No |
**Triggers**
| Trigger | Trigger ID | Fires when |
| ----------- | --------------------- | ------------------------------------------------ |
| On New File | `dropbox_on_new_file` | A file is added or changed in the watched folder |
**On New File is exact, not a re-scan.** Dropbox has a real cursor model, so the trigger asks "what changed since this cursor" rather than re-listing the folder and diffing. Nothing is missed between polls and nothing is reported twice. Each watched folder keeps its own cursor, so two workflows watching different paths don't interfere.
## 6. Example usage
**"File this signed contract under the Acme folder and send me a link."**
Runs **Save URL** into `/Clients/Acme/`, then **Create Shared Link**.
**"Find the March invoice."**
Runs **Search**, then **Get Temporary Link** for a direct download.
**"Someone overwrote the pricing sheet — put back Friday's version."**
Runs **List Revisions** → **Restore** with the right `rev`.
**"When a file lands in /Inbox, extract the data and log it."**
A workflow starts on **On New File** and chains into [PDF.co](/mcp/pdfco) or [OCR](/mcp/ocr).
## 7. Permissions & data access
**UnleashX CAN:**
* List, search and read files and folders in the connected account.
* Create, upload, move, copy, delete and restore.
* Create, list and revoke shared links, invite file members, and share folders.
* Report the connected account and its storage usage.
**UnleashX CANNOT:**
* Reach any Dropbox account other than the one you authorized.
* Permanently erase anything — deletes go to the Dropbox trash.
* Act beyond the scopes granted at authorization.
**To disconnect:** In UnleashX, open your agent → **Data Connectors** → **Dropbox** → **Disconnect**, or revoke at [Dropbox → Connected apps](https://www.dropbox.com/account/connected_apps). Revoking takes effect immediately.
## 8. Troubleshooting
| Problem | What it means | How to fix it |
| -------------------------------------------------------- | ---------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| `401 Unauthorized` | The token expired or access was revoked | Reconnect Dropbox in **Data Connectors** |
| `403` mentioning a scope | The app's token lacks that permission | Tick the scope in the Dropbox App Console **and** reconnect — an existing token won't gain it |
| `path/not_found` | The path is wrong, or it's missing its leading slash | Confirm with **List Folder** or **Search** |
| An accented or emoji filename fails with an opaque `400` | Dropbox requires ASCII in its argument header | Handled automatically by the connector — if you still hit it, report the exact path |
| Download returns nothing for a big file | **Download** is capped at 10 MB | Use **Get Temporary Link**, or **Save URL** in the other direction |
| A folder listing looks truncated | Listings page | Follow the cursor with **List Folder Continue** |
| The trigger reports nothing after a path change | The cursor is per watched path | Expected — a new path starts a fresh cursor |
For general connector issues, see [/mcp/integrations](/mcp/integrations).
## 9. Frequently asked questions
**Does UnleashX store my files?**
No. Tools call the Dropbox API live. Only **Download** returns file contents, and only inline into that workflow run.
**Can it upload a file from my computer?**
Not directly — **Upload** and **Save URL** both take a publicly reachable URL. Put the bytes somewhere fetchable first, or pass a link produced by an earlier workflow step.
**Are deletes permanent?**
No. They go to the Dropbox trash and can be restored from Dropbox.
**Can I connect more than one account?**
Yes. Authorize each account as its own connection.
**Does it work with Dropbox Business team folders?**
It works with what the authorized account can see. Team-wide admin operations aren't covered.
## 10. References
* Dropbox API v2 reference: [https://www.dropbox.com/developers/documentation/http/documentation](https://www.dropbox.com/developers/documentation/http/documentation)
* OAuth scopes: [https://developers.dropbox.com/oauth-guide](https://developers.dropbox.com/oauth-guide)
* Connected apps: [https://www.dropbox.com/account/connected\_apps](https://www.dropbox.com/account/connected_apps)