Dropbox Proxy

Communicates with Dropbox via a Cloudflare worker

Overview

This node acts as a proxy to communicate with Dropbox through a Cloudflare worker, enabling various file and folder operations on a Dropbox account. It is useful when you want to interact with Dropbox programmatically within an n8n workflow without directly calling the Dropbox API, leveraging a proxy service for potentially easier authentication or network routing.

Common scenarios include:

  • Copying, moving, deleting files or folders in Dropbox.
  • Uploading or downloading files.
  • Creating new folders.
  • Listing contents of folders.
  • Continuing a previous query to list folder contents using raw JSON parameters.

For example, you could use this node to automate backing up files by copying them to a specific Dropbox folder, or to process files by downloading them, manipulating locally, and re-uploading.

Properties

Name Meaning
Operation The action to perform on Dropbox. Options: Copy a File, Copy a Folder, Create a Folder, Delete a File, Delete a Folder, Download a File, List a Folder, Move a File, Move a Folder, Query, Upload a File.
Path The path of the file or folder to operate on (required for most operations except Query).
Destination Path The target path for move or copy operations.
Content (Base64) Base64 encoded content of the file to upload (required for Upload a File operation).
Query Parameters (JSON) Raw JSON object sent as the request body for the Query operation, allowing continuation of folder listing queries.

Output

The output is an array of items where each item contains:

  • json: The JSON response from the Dropbox API for the performed operation. This typically includes metadata about files/folders or confirmation of the action.
  • For the Download a File operation, the output includes a binary property containing the downloaded file data prepared for further binary processing in n8n workflows, alongside a JSON object confirming success and the file path.

Dependencies

  • Requires a configured API key credential for the Dropbox proxy service, including:
    • A URL endpoint of the Cloudflare worker acting as the proxy.
    • An access token for authorization.
  • No direct Dropbox credentials are used; all communication goes through the proxy.
  • Uses n8n's HTTP request helper methods and binary data handling utilities.

Troubleshooting

  • Missing Credentials Error: If the worker URL or access token is not set, the node will throw an error indicating missing credentials. Ensure the API key credential is properly configured.
  • File Content Required: For the upload operation, if no Base64 content is provided, an error is thrown. Make sure to supply valid Base64 encoded file content.
  • Unsupported Operation: If an invalid operation is selected, the node throws an error. Verify that the operation name matches one of the supported options.
  • HTTP Request Failures: Network issues or invalid paths may cause API errors. Check the proxy service availability and correctness of paths.
  • Binary Data Handling: For downloads, ensure subsequent nodes can handle binary data correctly.

Links and References

Discussion