Menu

Mattering Automations Dropbox integration

Connect Dropbox to Mattering Automations: files, folders, shared links, file requests, and revisions as workflow steps, authenticated with a Dropbox OAuth2 access token.

The Mattering Automations Dropbox integration adds Dropbox to your automation canvas: list and search files, read metadata and revisions, move, copy, and delete items, generate temporary links, manage shared links and members, and run file requests.

Setup takes a few minutes: create an app and access token in the Dropbox App Console, attach it as a credential in Mattering, and test the connection. This guide walks through each step and ends with the full node reference.

Before you start

  • A Dropbox account with access to the files and folders you want to automate.
  • A Mattering workspace with access to the Automations app.
  • Permission to create an app in the Dropbox App Console and generate an access token for it.

Create a Dropbox access token

Mattering authenticates to Dropbox with an OAuth2 access token, sent as a bearer credential. You generate it from an app you own in the Dropbox App Console.

Open the Dropbox App Console at dropbox.com/developers/apps and click Create app (or open an existing app).
On the app's Permissions tab, enable the scopes your automations need, such as files.metadata.read, files.content.read, files.content.write, and sharing.write, then save.
On the Settings tab, under OAuth 2, use Generate access token to create a token, or complete the OAuth2 flow to obtain one.
Copy the access token.
Set the scopes before you generate the token: a token minted without a scope cannot call the endpoints that need it, and you will get a permission error until you regenerate with the scope enabled.

Connect Dropbox to Mattering

In Mattering Automations, open Connectors and click Add Connector.
Choose Dropbox from the list.
Click Create new credential, paste your access token, and save.
The credential is stored encrypted in Google Secret Manager and never appears in workflow logs.
Click Test Connection: Mattering calls the Dropbox account endpoint and reports which account it authenticated as.
Click Connect. All 41 Dropbox nodes appear in your canvas palette.

Verify it works

After connecting, open any automation canvas and check the palette: a Dropbox section should list the query and action nodes. Drop Dropbox: Get Current Account onto the canvas and run a test step. It takes no arguments and is a safe, read-only call, so a successful response returns your account name, email, and account id without touching any files.

To confirm file access, add Dropbox: List Folder, set the path to an empty string for the account root or to a folder path such as /Documents, and run it. A successful response lists the folder's entries.

Node reference

41 nodes, generated from the connector itself so this reference always matches what ships.

Read and query nodes 22

Dropbox: Check (Echo)

dropbox_check_user

Echo endpoint for connectivity/token checks. body: {query: "ping"} -> {result: "ping"}.

Dropbox: Get Account

dropbox_get_account

Get another user's public account info. body: {account_id}.

Dropbox: Get Accounts (Batch)

dropbox_get_account_batch

Get several users' public account info. body: {account_ids: [...]}.

Dropbox: Get Current Account

dropbox_get_current_account

Get the account tied to the access token (name, email, account_id). No arguments.

Dropbox: Get File Request

dropbox_get_file_request

Get a single file request. body: {id}.

Dropbox: Get File/Folder Metadata

dropbox_get_metadata

Get metadata for a file or folder. body: {path: "/path/to/item", include_media_info?}.

Dropbox: Get Folder Latest Cursor

dropbox_get_folder_latest_cursor

Get a cursor pointing at a folder's current state (for change polling). body: {path, recursive?}.

Dropbox: Get Shared Folder Metadata

dropbox_get_shared_folder_metadata

Get metadata for a shared folder. body: {shared_folder_id}.

Dropbox: Get Shared Link Metadata

dropbox_get_shared_link_metadata

Get metadata for a shared link. body: {url, path?, link_password?}.

Dropbox: Get Space Usage

dropbox_get_space_usage

Get the account's storage usage + allocation. No arguments.

Dropbox: Get Temporary Download Link

dropbox_get_temporary_link

Get a short-lived direct DOWNLOAD URL for a file (4h TTL). body: {path}. Feed the returned .link into an HTTP node to fetch the bytes.

Dropbox: List File Members

dropbox_list_file_members

List who a file is shared with. body: {file, include_inherited?, limit?}.

Dropbox: List File Requests

dropbox_list_file_requests

List the account's file requests. body: {limit?}.

Dropbox: List Folder

dropbox_list_folder

List a folder's contents. body: {path: "" for root or "/Folder", recursive?, include_deleted?, limit?}. Paginate with the returned cursor via List Folder (Continue).

Dropbox: List Folder (Continue)

dropbox_list_folder_continue

Fetch the next page of a folder listing. body: {cursor}.

Dropbox: List Folder Members

dropbox_list_folder_members

List a shared folder's members. body: {shared_folder_id, limit?}.

Dropbox: List Revisions

dropbox_list_revisions

List a file's revision history. body: {path, mode?, limit?}.

Dropbox: List Shared Folders

dropbox_list_shared_folders

List shared folders the user is a member of. body: {limit?, actions?}.

Dropbox: List Shared Links

dropbox_list_shared_links

List shared links. body: {path?, cursor?, direct_only?}. Omit path to list all.

Dropbox: Save URL (Check Job)

dropbox_save_url_check_job

Poll a save_url job. body: {async_job_id}.

Dropbox: Search

dropbox_search

Search files/folders. body: {query, options?: {path, max_results, file_status, filename_only}}.

Dropbox: Search (Continue)

dropbox_search_continue

Fetch the next page of search results. body: {cursor}.

Action nodes 19

Dropbox: Add File Member

dropbox_add_file_member

Share a file with members. body: {file, members: [{.tag, email/dropbox_id}], access_level?, custom_message?}.

Dropbox: Add Folder Member

dropbox_add_folder_member

Add members to a shared folder. body: {shared_folder_id, members: [{member: {.tag,email}, access_level}], custom_message?}.

Dropbox: Copy (Batch)

dropbox_copy_batch

Copy multiple items in one call (async). body: {entries: [{from_path, to_path}, ...], autorename?}.

Dropbox: Copy File/Folder

dropbox_copy

Copy a file or folder. body: {from_path, to_path, autorename?}.

Dropbox: Create File Request

dropbox_create_file_request

Create a file request (an upload inbox). body: {title, destination: "/Uploads", deadline?, open?}.

Dropbox: Create Folder

dropbox_create_folder

Create a folder. body: {path: "/New Folder", autorename?}.

Dropbox: Create Shared Link

dropbox_create_shared_link

Create a shareable link for a file/folder. body: {path, settings?: {access, audience, requested_visibility, expires}}.

Dropbox: Delete (Batch)

dropbox_delete_batch

Delete multiple items in one call (async). body: {entries: [{path}, ...]}.

Dropbox: Delete File Request

dropbox_delete_file_request

Delete closed file requests. body: {ids: [...]}.

Dropbox: Delete File/Folder

dropbox_delete

Delete a file or folder (to trash). body: {path}.

Dropbox: Get Temporary Upload Link

dropbox_get_temporary_upload_link

Get a one-shot UPLOAD URL (POST bytes to it, no auth needed). body: {commit_info: {path, mode?, autorename?}, duration?}. Lets an HTTP node upload without binary handling here.

Dropbox: Modify Shared Link Settings

dropbox_modify_shared_link_settings

Change a shared link's settings. body: {url, settings, remove_expiration?}.

Dropbox: Move File/Folder

dropbox_move

Move/rename a file or folder. body: {from_path, to_path, autorename?, allow_shared_folder?}.

Dropbox: Remove File Member

dropbox_remove_file_member

Remove a member from a shared file. body: {file, member: {.tag, email/dropbox_id}}.

Dropbox: Restore File Revision

dropbox_restore

Restore a file to a previous revision. body: {path, rev}.

Dropbox: Revoke Shared Link

dropbox_revoke_shared_link

Revoke a shared link. body: {url}.

Dropbox: Save URL to Dropbox

dropbox_save_url

Server-side: Dropbox downloads a remote URL straight into the account (async). body: {path, url}. Returns an async_job_id; poll with Save URL (Check Job).

Dropbox: Share Folder

dropbox_share_folder

Turn a folder into a shared folder (may be async). body: {path, acl_update_policy?, member_policy?}.

Dropbox: Update File Request

dropbox_update_file_request

Update a file request. body: {id, title?, destination?, deadline?, open?}.

Using the integration

On the automation canvas

Dropbox nodes chain with every other node: a new file can create an assigned task in Mattering Productivity, an AI step can summarize a document, and a shared link can be posted to a message or email in the same flow.

From AI assistants over MCP

Every node speaks MCP, the open protocol for connecting AI assistants to tools. Claude, ChatGPT, and Matter can list, move, share, and read files through the same nodes your workflows use.

Moving file bytes without binary in a node

Use Dropbox: Get Temporary Download Link to hand an HTTP node a direct download URL, Dropbox: Get Temporary Upload Link to post bytes to a one-shot upload URL, and Dropbox: Save URL to Dropbox to have Dropbox fetch a remote URL server-side.

Beyond the typed nodes

The generic Dropbox request node calls any Dropbox API path your token is scoped for, so surfaces the typed nodes do not name stay reachable without waiting on a connector update.

Troubleshooting

Test Connection fails with a 401
The access token is invalid, revoked, or expired. Dropbox short-lived tokens expire; generate a fresh token in the App Console and update the credential on the connector.
A node returns a scope or permission error
The token was minted without the scope that endpoint needs. Enable the scope on the app's Permissions tab in the App Console, regenerate the token, and update the credential. Sharing and write endpoints need their write scopes, not just read.
A file or folder call returns a path error
Dropbox paths are case-sensitive and start with a forward slash, such as /Documents/report.pdf, and the account root is an empty string, not a slash. Read the exact path with Get File/Folder Metadata or List Folder, then reuse it.
A temporary download or upload link stops working
Temporary download links are short-lived (a four-hour window) and temporary upload links are one-shot. Generate the link in the same run that uses it rather than storing it for later, and request a new one if a step retries after the window.
Save URL or a batch node returns a job id instead of a result
Save URL, Copy (Batch), and Delete (Batch) run asynchronously and return an async_job_id. Poll it with the matching check-job node until the job completes rather than treating the first response as the final result.

Dropbox is a trademark of its respective owner. Mattering uses platform names to identify the services these integrations connect to; no endorsement or affiliation is implied.

Start Free Explore our Products