> ## Documentation Index
> Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Dropbox

> Integrate your application with the Dropbox API

## 🚀 Quickstart

Connect to Dropbox with Nango and see data flow in 2 minutes.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to [Integrations](https://app.nango.dev/dev/integrations) -> *Configure New Integration* -> *Dropbox*. Nango doesn't have a Nango-managed OAuth app for Dropbox yet. You'll need to set up your own by following the setup guide linked below. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.

**2. Authorize Dropbox**

Go to [Connections](https://app.nango.dev/dev/connections) -> *Add Test Connection* -> *Authorize*, then log in to Dropbox. Later, you'll let your users do the same directly from your app.

**3. Call the Dropbox API**

Let's make your first request to the Dropbox API. Replace the placeholders below with your [Environment API key](https://nango.dev/docs/reference/backend/http-api/api-keys.md), [integration ID](https://app.nango.dev/dev/integrations), and [connection ID](https://app.nango.dev/dev/connections):

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/2/files/list_folder" \
>   -X POST \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>" \
>   -H "Content-Type: application/json" \
>   -d '{"path": ""}'
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.post({
>     endpoint: '/2/files/list_folder',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>',
>     body: { path: '' }
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the [Logs](https://app.nango.dev/dev/logs) tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/primitives/auth.md) to integrate Nango in your app.

To obtain your own credentials, follow the setup guide linked below.

## 📚 Dropbox Integration Guides

Nango maintained guides for common use cases.

* [How to register your own Dropbox OAuth app](https://nango.dev/docs/api-integrations/dropbox/how-to-register-your-own-dropbox-api-oauth-app)\
  Register an OAuth app with Dropbox and obtain credentials to connect it to Nango

Official docs: [Dropbox API documentation](https://developers.dropbox.com/oauth-guide)

## 🧩 Pre-built syncs & tools for Dropbox

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

### Others

| Function name | Description | Type |
| - | - | - |
| `batch-copy-files-or-folders` | Copy multiple files or folders to new Dropbox paths in one batch job | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `batch-create-folders` | Create multiple Dropbox folders in one batch request | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `batch-delete-files-or-folders` | Delete multiple Dropbox files or folders in one batch job | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `batch-move-files-or-folders` | Move multiple Dropbox files or folders to new locations in one batch job. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-batch-copy-files-or-folders` | Check the status of a Dropbox batch copy job using its async job ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-batch-delete-files-or-folders` | Check the status of a Dropbox batch delete job using its async job ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-batch-move-files-or-folders` | Check the status of a Dropbox batch move job using its async job ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `check-unshare-folder` | Check the status of a Dropbox unshare folder job using its async job ID. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `copy-file-or-folder` | Copy a Dropbox file or folder to a different path. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-folder` | Create a folder at a Dropbox path. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-shared-link` | Create a shared link for a Dropbox file or folder with optional settings. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-user` | Creates a user in Dropbox. Requires Dropbox Business. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-file-or-folder` | Delete a Dropbox file or folder by path | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-user` | Deletes a user in Dropbox. Requires Dropbox Business. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `download-file` | Download file contents from Dropbox. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `download-folder-as-zip` | Download a Dropbox folder as a zip archive | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-current-account` | Retrieve the authenticated Dropbox account profile. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-file-or-folder-metadata` | Retrieve metadata for a Dropbox file or folder | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-file-temporary-link` | Generate a temporary Dropbox link for file content streaming. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-file-revisions` | List revisions for a Dropbox file by path or file id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-folder` | List Dropbox folder contents with pagination and optional recursion. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-shared-folders` | List shared folders available to the current Dropbox user. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-shared-links` | List shared links for the current user or for a specific path | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `modify-shared-link-settings` | Update settings on an existing Dropbox shared link. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `move-file-or-folder` | Move a Dropbox file or folder to a different path | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `restore-file-revision` | Restore a previous Dropbox file revision to the current path | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `revoke-shared-link` | Revoke a Dropbox shared link so it no longer grants access. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-files-and-folders` | Search Dropbox files and folders by query text and path scope. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `share-folder` | Turn a Dropbox folder into a shared folder for collaborators | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `unshare-folder` | Unshare a Dropbox shared folder as its owner. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `upload-file` | Upload a small file directly to Dropbox. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `upload-large-file` | Upload a large file to Dropbox with an upload session | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `files` | Sync Dropbox file metadata from configured root paths using list folder cursors. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `folders` | Sync Dropbox folder metadata from configured root paths. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `shared-folders` | Sync shared folder metadata visible to the current Dropbox user. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `shared-links` | Sync Dropbox shared links for the current user or configured path scopes. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

***


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.