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.
Connect Dropbox to Mattering
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
A node returns a scope or permission error
A file or folder call returns a path error
A temporary download or upload link stops working
Save URL or a batch node returns a job id instead of a result
Related
The Dropbox MCP
What connecting Dropbox unlocks for AI agents and automations, with common uses and FAQs.
More guides
All Automations documentation
Every integration guide, plus how connectors, credentials, and workflows fit together.
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.