Dropbox Proxy

Communicates with Dropbox via a Cloudflare worker

Actions11

Overview

This node acts as a proxy to interact with Dropbox via a Cloudflare worker, enabling various file and folder operations on a Dropbox account. It supports actions such as listing folder contents, copying, moving, deleting files or folders, uploading files, downloading files, creating folders, and running custom queries.

A common use case is automating Dropbox file management workflows within n8n, for example:

  • Listing the contents of a specific Dropbox folder to process or analyze files.
  • Uploading new files automatically from other systems.
  • Moving or copying files/folders based on business logic.
  • Downloading files for further processing in n8n workflows.

Specifically, the "List a Folder" operation retrieves metadata about the contents of a specified Dropbox folder path, which can be used to iterate over files or trigger downstream actions.

Properties

Name Meaning
Path The path of the file or folder in Dropbox to operate on. For "List a Folder", this is the folder path whose contents will be listed.

Note: The provided properties JSON only includes the "Path" property relevant for the "List a Folder" operation.

Output

The output for the "List a Folder" operation is a JSON object representing the response from Dropbox's list_folder API endpoint. This typically includes:

  • An array of entries describing files and folders inside the specified path.
  • Metadata fields such as names, paths, IDs, types (file or folder), and other attributes.
  • Flags indicating if there are more entries available for pagination.

Example structure (simplified):

{
  "entries": [
    {
      ".tag": "file",
      "name": "example.txt",
      "path_lower": "/folder/example.txt",
      "id": "id:abc123",
      ...
    },
    {
      ".tag": "folder",
      "name": "subfolder",
      "path_lower": "/folder/subfolder",
      "id": "id:def456",
      ...
    }
  ],
  "cursor": "some_cursor_token",
  "has_more": false
}

No binary data is output for this operation.

Dependencies

  • Requires an API key credential for authenticating with the Dropbox proxy Cloudflare worker.
  • The node expects two credential parameters: a worker URL and an access token.
  • No direct Dropbox SDK usage; all communication is done via HTTP requests to the proxy service.
  • The node uses n8n's HTTP request helper methods and buffer utilities.

Troubleshooting

  • Missing credentials error: If the worker URL or access token is not set or invalid, the node will throw an error indicating missing credentials. Ensure the API key credential is properly configured.
  • Unsupported operation error: If an unsupported operation name is passed, the node throws an error. Verify the operation parameter is one of the supported options.
  • Empty or invalid path: The "Path" property is required. Providing an empty or incorrect path may cause API errors or unexpected results.
  • API request failures: Network issues or invalid tokens can cause HTTP request failures. Check connectivity and credential validity.
  • File content missing for upload: For upload operations, the base64 encoded file content must be provided; otherwise, an error is thrown.

Links and References

Discussion