Dropbox integration

What it does

The Dropbox integration lets your agency move work in and out of your clients' Dropbox accounts without leaving TaskJuice. Connect an account once and your workflows can list folders, create new folders, move or copy files, soft-delete files, fetch metadata, and mint shared links against the Dropbox HTTP API v2. When something changes inside the connected account, Dropbox notifies TaskJuice and your workflow can react in seconds.

Connect a Dropbox account

1. Open your workspace in TaskJuice and navigate to Connections.
2. Choose Dropbox and click Connect.
3. Sign in to the Dropbox account you want to wire up and approve the requested scopes (files.metadata.read, files.content.read, files.content.write, sharing.write, sharing.read).
4. TaskJuice returns you to the workspace with the connection ready to use in any workflow.

To revoke access, open dropbox.com, go to Settings, Connected apps, and remove the TaskJuice authorization. The full grant flow is documented in the Dropbox OAuth guide.

Triggers

• dropbox/account-changed fires when any state changes in a connected Dropbox account (file added, removed, or modified). The activation payload carries the list_folder.accounts array Dropbox sends; downstream workflow steps call dropbox/list-folder to materialize the delta.

Every inbound POST is authenticated by recomputing HMAC-SHA256 over the raw request body using your Dropbox app secret, and comparing the hex digest against the value Dropbox sends in the X-Dropbox-Signature header. Activations that fail the check are rejected before they reach your workflow.

Actions

• dropbox/list-folder lists the immediate contents of a folder by path, with cursor pagination via the cursor returned in the response.
• dropbox/get-metadata fetches metadata for a single file or folder by path or id: reference.
• dropbox/create-folder creates a new folder at the supplied path, with an option to auto-rename on conflict.
• dropbox/delete soft-deletes a file or folder by path. Items remain restorable from the Dropbox trash window.
• dropbox/move moves a file or folder from one path to another, with optional auto-rename and ownership-transfer flags.
• dropbox/copy copies a file or folder to a new path, with the same conflict-handling flags as move.
• dropbox/create-shared-link creates a shareable URL for a file or folder, with optional visibility, audience, and access settings.

Known limitations

• The Dropbox API enforces per-app rate limits. When a 429 status is returned, TaskJuice surfaces it as a retryable error so the workflow can back off and retry.
• Webhook notifications carry only the affected account_id values, not the changed file list. Workflows must call dropbox/list-folder with the cursor stored in state to learn what actually changed.
• This integration covers the JSON-RPC endpoints under api.dropboxapi.com/2/*. Content-upload and content-download endpoints (which require a separate binary host) are not exposed.
• File and folder paths are case-insensitive in Dropbox storage but case-preserving in metadata; pass paths in the casing you want surfaced in the UI.