Dropbox
The Dropbox modules enable you to monitor, search, retrieve, or list files and create and edit files and folders in your Dropbox account.
Getting Started with Dropbox
Prerequisites
A Dropbox account
In order to use Dropbox with Make, it is necessary to have a Dropbox account. If you do not have one, you can create a Dropbox account at www.dropbox.com/register.
Note
The module dialog fields that are displayed in bold (in the Make scenario, not in this documentation article) are mandatory!
Connecting Dropbox to Make
To connect your Dropbox account to Make follow the general instructions for Connecting to services.
After you click the Continue button, Make will redirect you to the Dropbox website where you will be prompted to grant Make access to your account.

Confirm the dialog by clicking the Allow button.
Or (for Dropbox Business) allow access by selecting the account you want to connect Make to:

Trigger Files
Watch Files
Returns file details when the file in a specified folder is modified.
Connection | |
Folder | Select the folder you want to watch for changes. |
Watch also subfolders | Enable this option to monitor also subfolders for modified files. |
Limit | Set the maximum number of files Make will return during one execution cycle. |
Get Files/Folders
Search Files/Folders
Searches for the files or folders by the specified search term and filter settings.
Required Permissions: files.metadata.read
Connection | |
Search | Enter the search term. |
Folder | Select the folder you want to search. Searches the entire Dropbox if not specified. |
File Status | Select the file status to restrict the search to the selected file status. |
File Categories | Select the file categories to restrict the search to the selected categories. |
File extensions | Specify the file extensions you want to search for. |
Limit | Set the maximum number of results Make will return during one execution cycle. |
Get a File
Downloads a file from the specified folder.
Useful for providing files to subsequent modules.
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File Path / File | File Path Specify the target path to the file. ![]() File Select the file from the menu. |
Get a Folder Metadata
Retrieves shared folder details.
Required Permissions: sharing.read
Connection | |
Shared Folder ID | Enter (map) the ID of the folder you want to retrieve details about. |
List All Files/Subfolders in a Folder
Returns files or folders in the specified folder.
Required Permissions: files.metadata.read
Connection | |
List | Select whether you want to retrieve files or folders. |
Show Only Downloadable Files | Enable this option to return only downloadable files. Non-downloadable files can be, for example, Google Docs. |
Folder | Specify the folder you want to retrieve files or folders from. |
Limit | Set the maximum number of results Make will return during one execution cycle. |
List File Revisions
Retrieves all file revisions, a version history, of the specified file.
Required Permissions: files.metadata.read
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File Path / File | File Path Specify the target path to the file. ![]() File Select the file from the menu. |
Limit | Set the maximum number of revisions Make will return during one execution cycle. |
Create & Edit File/Folder
Upload a File
Uploads a provided file to the selected folder.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Folder | Select the folder of your Dropbox you want to upload the file to. |
Source File | Specify the file you want to add to the Dropbox folder selected above. File name Enter or map the file name, including the file extension. File data Enter or map the file data (from previous module, e.g. Google Drive > Get a File) CautionThe maximum size of the uploaded file is 150 MB. |
Overwrite an existing file | Enable this option to replace the existing file with the new file. If this option is left disabled, the uploaded file will be renamed. |
Create a Folder
Creates a new folder in the specified path.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Folder Name | Enter the name for the new folder. |
Folder | Specify the path where you want to create a new folder. In case you are using a Dropbox Business account (with team spaces) remove the slash ![]() If the slash is not removed an error |
Auto rename | Enable this option to rename the new folder, if the folder with the same name already exists in the target location. |
Create/Overwrite a Text File
Creates a DOC file or overwrites the content of an existing one.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Select to | Select whether you want to Create or Overwrite a DOC file. |
Folder | Select the target location you want to create a file at. |
Source File | Specify the file you want to add to the Dropbox folder. File name Enter the file name for the new DOC file (without an extension). File Content Enter the text content of the DOC file. |
Restore a File
Restores a previous version of the file.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File Path / File | File Path Specify the target path to the file. File Select the file from the menu. |
Revision | Enter or map the revision number of the revision you want to restore. |
Move a File/Folder
Moves a file or folder to a different location in your Dropbox.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File/Folder Path / File/Folder | File/Folder Path Specify the target path to the file or folder. File/Folder Select the file or folder from the menu. |
To Folder | Specify the target location for the file/folder. |
New Name | Enter the new name for the file/folder in the new location. |
Auto Rename | Renames the new file/folder, if the file/folder with the same name exists. Adds (NUMBER) after the file/folder name. Otherwise the file/folder in the target location will be overwritten. |
Allow ownership transfer | Enable this option to allow moves by owner even if it would result in an ownership transfer for the content being moved. |
Rename a File/Folder
Renames a file or folder.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File/Folder Path / File/Folder | File/Folder Path Specify the target path to the file or folder. File/Folder Select the file or folder from the menu. |
Rename | Enter the target name for the file, including the file extension. |
Delete a File/Folder
Deletes a file from your Dropbox.
Required Permissions: files.content.write, files.metadata.read
Connection | |
Way of selecting files | Select whether you want to map/specify the file path or select the file manually. |
File Path / File | File Path Specify the target path to the file. File Select the file from the menu. |
Make an API Call
Allows you to perform a custom API call.
Connection | |
URL | Enter a path relative to Enter a path relative to NoteFor the list of available endpoints, refer to the Dropbox API v2 Documentation. |
Method | Select the HTTP method you want to use:
|
Headers | Enter the desired request headers. You don't have to add authorization headers; we already did that for you. |
Query String | Enter the request query string. |
Body | Enter the body content for your API call. |
Example of Use - List From the Folder
The following API call returns the first 10 files from the /Text files folder in your Dropbox account:
URL:
/2/files/list_folder
Body:
{ "path": "/Text files", "limit": 10, "recursive": false, "include_deleted": false }

Matches of the search can be found in the module's Output under Bundle > Body > entries.
In our example, 10 tickets were returned:

Common problems
Unable to upload or update a file
There are several situations when uploading or updating a file fails:
The uploaded file is too big and exceeds the maximum file size allowed for your Dropbox plan or you have used all of your Dropbox account's storage quota. You will either need to delete existing files from your Dropbox account or upgrade your plan.
The previously selected folder, to which the file is being uploaded to, no longer exists. The scenario gets stopped and you will need to select the target folder again.