Skip to main content

Dropbox

Lists and downloads files from a Dropbox folder on demand.

Overview​

The Dropbox action node retrieves all files from a specified Dropbox folder. Unlike the Dropbox Trigger which polls for changes over time, this node fetches files once as part of a workflow execution.

Use it to:

  • Process all existing files in a Dropbox folder
  • List files for filtering and selective processing
  • Retrieve files on demand from Dropbox

Parameters​

ParameterDescriptionRequired
CredentialDropbox account to useYes
FolderDropbox folder path (e.g. /Reports), empty for homeNo
LimitMaximum files to return (1-1000, default 500)Yes

Folder​

The path of the Dropbox folder to list files from, such as /Reports. Leave empty to list files from your home folder. Supports expressions for dynamic folder selection:

{{$item.data.folder}}

Settings​

SettingDescription
Execution ModeOnce per item (default) or Once
Output ModeHow to output results when running once
Batch SizeItems to process concurrently (default 5)
Stop on ErrorStop workflow on failure

Output​

One item per file found in the folder:

{
"file": {
"type": "fileData",
"name": "spreadsheet.xlsx",
"mimeType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"fileInfo": {
"type": "dropbox",
"credentialId": "..."
}
}
}

Access file properties in expressions:

  • File object: {{$item.data.file}}
  • File name: {{$item.data.file.name}}
  • MIME type: {{$item.data.file.mimeType}}

Examples​

Process Dropbox Files​

[Manual Trigger] → [Dropbox (folder)] → [Data Extractor] → [Insert Rows]

Batch Convert Excel Files​

[Dropbox (folder)] → [Filter (mimeType contains "spreadsheet")] → [Excel to PDF] → [Copy File]

Process Files from Multiple Folders​

[Import Table (folder paths)] → [Dropbox] → [Data Extractor] → [Insert Rows]

Authentication​

This node requires a connected Dropbox account. Configure credentials in your workspace settings.

Tips​

  • Returns files only — subfolders are not included
  • Not recursive — only lists files directly in the specified folder
  • Leave Folder empty to list files from your home folder
  • Use the Dropbox Trigger for continuous monitoring; use this node for one-time retrieval
  • Each file in the folder becomes a separate output item