Dropbox Step

The Dropbox step uploads files to a Dropbox account using a named connection. You can place any combination of user-uploaded and workflow-generated files into a target folder, making them accessible to collaborators or downstream systems.

Configuration

name	type	required	description
`connection`	string	yes	The name of the Dropbox connection to use, as configured in Integrations.
`action`	string	yes	The operation to perform. Must be `UPLOAD_FILE`.
`folder`	string	no	The target folder path within Dropbox (e.g. `/Projects/Onboarding`).
`files`	array	yes	One or more files to upload. At least one file is required. See Files below.

Files

Each entry in the files array defines a file to upload and where it comes from.

name	type	required	description
`source`	string or object	yes	The file to upload. See File sources below.
`name`	string	yes	The file name to use in Dropbox.

File sources

The source field accepts several formats depending on where the file comes from:

Object reference with ID: { "id": "string", "downloadUrl": "string" } — references a file by its ID. Both id and downloadUrl are required.
Object reference with URL only: { "downloadUrl": "string" } — references a file by download URL, without an ID.
Generated file descriptor: { "name": "string", "metadata": { "contentType": "string", "size": number, "createdAt": "string", "updatedAt": "string" } } — describes a workflow-generated file. Only name is required; all metadata fields are optional.
String URL or handle: A plain string used as a direct file reference.

Example

The example below uploads two files to a Dropbox folder: one referenced by ID and one described as a workflow-generated file.

{
  "connection": "dropbox-prod",
  "action": "UPLOAD_FILE",
  "folder": "/Projects/Onboarding",
  "files": [
    {
      "source": {
        "id": "file-789",
        "downloadUrl": "https://files.example.com/download/file-789"
      },
      "name": "welcome.pdf"
    },
    {
      "source": {
        "name": "intro.txt",
        "metadata": {
          "contentType": "text/plain",
          "size": 128
        }
      },
      "name": "intro.txt"
    }
  ]
}