🇬🇧 EN

📦 Dropbox

Reads or writes files in a Dropbox account. Supports downloading files, uploading new content, and overwriting existing files. Requires Dropbox OAuth credentials from Settings → Integrations.

Category: File Operations · Type identifier: dropbox

Overview

The Dropbox node connects Flusso workflows to your Dropbox storage. You can read a file's contents into the workflow context for processing, upload generated content as a new file, or overwrite an existing file at a known path.

Dropbox paths always start with a forward slash and use the same structure shown in the Dropbox web interface — for example, /Reports/output.csv. Paths support {{ variable }} references so you can build dynamic filenames from workflow data.

Prerequisite: Dropbox credentials must be connected in Settings → Integrations before this node can access your account. An administrator must complete this step once for your Flusso account.

Configuration

Field	Status	Description
Credential	Required	Dropbox account credential from Settings → Integrations.
Operation	Required	`read` — download file content. `write` — upload new or overwrite existing.
Path	Required	The full Dropbox path including filename, e.g. `/reports/output.csv`. Supports `{{ variable }}` references.
Content	Required for write	Content to upload. Supports `{{ variable }}` references.
Overwrite	Optional — write mode	Toggle. When off, the operation fails if a file already exists at the path. Default: on.
Mode	Optional — write mode	`add` — auto-rename the file if one already exists at the path. `overwrite` — replace any existing file at the path. `update` — update a specific revision of the file. Default: `overwrite`.

Output Data

These fields are available in subsequent steps using the node's step key.

Field	Type	Description
`content`	string	File content (read mode).
`path`	string	Dropbox path of the file.
`size`	number	File size in bytes.
`modified_at`	string	ISO 8601 last-modified timestamp.

Example Usage

A Schedule Trigger fires each Monday morning.
An HTTP Request node fetches the latest data from an external API.
A Transform node formats the data as a CSV string.
A Dropbox node with Operation: write uploads the CSV to /Reports/{{ trigger.output.week }}-report.csv in a folder shared with clients.

Tips & Notes

Dropbox paths are case-insensitive on Windows and macOS but treated as case-sensitive by the Dropbox API. Use consistent casing to avoid unexpected behaviour.
Use Mode: add when you want Dropbox to auto-rename the file if one already exists (e.g. output (1).csv) rather than overwriting it.
The modified_at output is useful for audit logging — pass it to a Google Sheets append step to track when each file was last updated.
Shared folders and Team Spaces are accessible as long as the connected Dropbox account has the appropriate permissions.

Related Nodes

Google Drive — Google's cloud file storage alternative.
Local File — server-side file operations without cloud credentials.
Amazon S3 — scalable object storage for large files or high-volume workflows.