Skip to main content
Let’s learn how to connect Engini to Dropbox. This integration lets your workflows search, read and manage files and folders in Dropbox, create and delete shared links, work with file requests, and start a workflow when new files are added to a folder. To get started, create an account at Dropbox.

Add a Connection to Dropbox in Engini

Prerequisites

  • A Dropbox account.
  • Only for the Custom OAuth 2.0 method: a Dropbox app created in the Dropbox App Console (see below).

Create your Dropbox app (Custom OAuth 2.0 only)

With the OAuth2 method you sign in to Dropbox and don’t need your own Dropbox app, so you can skip this section. With the Custom OAuth 2.0 method, Engini connects to Dropbox through an app that you create in your own Dropbox account.
  1. Sign in to Dropbox and open the App Console.
  2. Select Create app, choose Scoped access and then Full Dropbox, enter a name for the app and select Create app.
  3. Open the app’s Permissions tab, turn on these permissions and select Submit: account_info.read, files.metadata.read, files.metadata.write, files.content.read, files.content.write, sharing.read, sharing.write, file_requests.read and file_requests.write.
  4. Open the app’s Settings tab. Under Redirect URIs, add this address and select Add: https://workflowapi.engini.io/api/auth/OAuthRedirectUrl
  5. On the same tab, copy the App key and the App secret. You will enter them in Engini as the Client Id and the Client Secret.
Note: If you change the permissions after you connected, sign in to Dropbox again from the connection so that the new permissions apply.

Connecting Engini to Dropbox

  1. Enter your Engini account at https://app.engini.io.
  2. Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here. Engini - Connections page
  3. Click on the “New Integration” option located at the top bar. Engini - New Integration button
  4. Choose the Dropbox option from the available applications. Dropbox - Choose Application
  5. Enter the following details in the “New Integration” form and press Save. There are two authentication methods, and the form differs depending on the one you choose. Follow the instructions for your method.

OAuth2

This method uses Engini’s own Dropbox app, so you don’t need to create a Dropbox app or enter a Client Id or Client Secret. You sign in with your Dropbox account. Dropbox - New Integration form with OAuth2 1. Connection Name - Enter a name that helps identify the Dropbox connection, for example “Dropbox - Finance”. 2. Authentication Method - Select OAuth2. 3. Signin - Click Signin, sign in to Dropbox and approve the access request. You return to Engini when it is done. 4. Save - Click Save to create the connection.

Custom OAuth 2.0

This method connects through the Dropbox app you created above, so you must enter its Client Id and Client Secret. Dropbox - New Integration form with Custom OAuth 2.0 1. Connection Name - Enter a name that helps identify the Dropbox connection, for example “Dropbox - Finance”. 2. Authentication Method - Select Custom OAuth 2.0. 3. Callback URL - A read-only field that shows the address Dropbox sends you back to after you sign in (https://workflowapi.engini.io/api/auth/OAuthRedirectUrl). Click the copy button next to it and make sure this address is listed under Redirect URIs in your Dropbox app. Do this before you sign in. 4. Client Id - Enter the App key of your Dropbox app. You can find it in the Dropbox App Console, on your app’s Settings tab. 5. Client Secret - Enter the App secret of the same Dropbox app, from the same tab. 6. Signin - This button stays greyed out (“Fill in to continue: Client Id, Client Secret”) until you fill in the Client Id and Client Secret. Then click it, sign in to Dropbox and approve the access request. You return to Engini when it is done. 7. Save - Click Save to create the connection.

Triggers

Check for New Files

Starts the workflow for every new file added to a Dropbox folder, including its subfolders. Engini checks the folder on the schedule you set. The first check only records the files that are already in the folder and starts nothing. After that, each check starts the workflow once for every new file. Dropbox - Check for New Files trigger
  1. Folder - Select the folder to watch from the list, or map a folder path from an earlier step. The trigger watches this one folder only.
  2. Starting (UTC) - Select the date and time of the first check.
  3. Recur every - Choose how often Engini checks the folder for new files. The minimum interval is 15 minutes.
  4. Add time frame - Click Add time frame to limit the checks to certain hours of the day.
Note: The trigger starts the workflow for new files only. A file that is edited later does not start it again. Adding a new folder can make one file you already received start the workflow a second time. Each new file is passed to the next steps with these properties: Revision, Type, Name, Id, Path Display, Path Lower, Client Modified, Is Downloadable, Content Hash, Server Modified and Size.

Actions

Dropbox identifies every file and folder by its path, which starts with /, for example /Invoices/report.pdf. Wherever an action asks for a path, you can select the item from a list of your Dropbox, map a path from an earlier step, or type it yourself. Fields that ask for a folder list your folders. Fields that ask for a file or a folder list both.

Copy File Or Folder

Copies a file or a folder, with everything in it, to a new location. The original stays where it is. Dropbox - Copy File Or Folder action
  1. Path - The file or folder to copy. Select it from the list, or map its path from an earlier step.
  2. To Path - The full path of the copy, including the name it will have, for example /Archive/report.pdf.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Allow Ownership Transfer - Choose whether Dropbox may transfer the ownership of the item when the copy needs it.
  • Allow Shared Folder - Choose whether a shared folder can be copied.
  • Autorename - Choose whether Dropbox gives the copy a different name when the name is already taken, instead of failing.

Create File Request

Creates a Dropbox file request, so other people can upload files to a folder of yours without needing a Dropbox account. Dropbox - Create File Request action
  1. Destination - The Dropbox folder where the uploaded files are saved. Select it from the list, or map its path from an earlier step, for example /File Requests/Project Documents.
  2. Title - The name of the file request, for example Project documents.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Description - A short text that explains what people should upload.
  • Open - Choose whether the file request accepts uploads right away.

Create Folder

Creates a new folder in your Dropbox. Dropbox - Create Folder action
  1. Path - The folder to create it in. Select it from the list, or map its path from an earlier step. If you leave it empty, the folder is created in the main folder of your Dropbox.
  2. Name - The name of the new folder, for example Invoices 2026.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following is optional and is added through Add Field:
  • Autorename - Choose whether Dropbox gives the folder a different name when the name is already taken, instead of failing.

Create or Update Text File

Saves text as a file in a Dropbox folder. If a file with the same name already exists in the folder, its content is replaced. Dropbox - Create or Update Text File action
  1. Folder - The folder to save the file in. Select it from the list, or map its path from an earlier step.
  2. File Name - The name of the file, including its extension, for example notes.txt.
  3. Text Content - The text to save in the file. You can write it here or map it from an earlier step.
Creates a shared link for a file or a folder, so people can open it through the link. Dropbox - Create Share Link action
  1. Path - The file or folder to share. Select it from the list, or map its path from an earlier step, for example /Documents/report.pdf.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
The following is optional and is added through Add Field:
  • Settings - The settings of the link: Access, Requested Visibility, Allow Download and Audience. Choose a value for each one you want to set. Access can be Max, Default, Editor or Viewer.

Delete Closed File Requests

Deletes file requests that are already closed. Dropbox - Delete Closed File Requests action
  • Ids - The Ids of the closed file requests to delete, as a list, for example ["oaCAVmEyrqYnkZX9955Y","bF93kLmPqR2xYz12345"]. You can map the Ids from a previous Get File Requests step.
Note: Dropbox does not delete a file request that is still open. Close it in Dropbox first.

Delete File Or Folder

Deletes a file, or a folder together with everything in it. Dropbox - Delete File Or Folder action
  • Path - The file or folder to delete. Select it from the list, or map its path from an earlier step.
Note: Deleting a folder deletes everything inside it. Deletes a shared link, so it stops working. The file or folder itself is not deleted. Dropbox - Delete Share Link action
  • Share Link - The shared link to delete. Map it from an earlier step, for example from Create Share Link, or paste the link itself.
Note: People who use the link lose access as soon as it is deleted.

Download File

Gets the content of a file, so later steps can use it. Dropbox - Download File action
  • File Path - The file to download. Select it from the list, or map its path from an earlier step, for example /Invoices/report.pdf.

Get File

Retrieves the details of a file, such as its name, size, dates and revision. Dropbox - Get File action
  • Path - The file to look up. Select it from the list, or map its path from an earlier step, for example /Invoices/report.pdf.

Get File Request

Retrieves the details of one file request. Dropbox - Get File Request action
  • Id - The file request to retrieve. Select it from the list, or map an Id from an earlier step.

Get File Requests

Retrieves the file requests of the connected Dropbox account. Dropbox - Get File Requests action
  • Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).

Get File Revisions

Retrieves the version history of a file, so you can see its earlier versions. Dropbox - Get File Revisions action
  1. Path - The file whose versions you want. Select it from the list, or map its path from an earlier step.
  2. Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).

Get Files and Folders

Searches your Dropbox for files and folders that match some text. Dropbox - Get Files and Folders action
  1. Search Text - The text to look for, for example invoice.
  2. Top N - You can set the maximum number of records Engini will return (default = 100, minimum = 1).
  3. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
All of the following are optional and are chosen through Add Filter:
  • Order By - Choose how the results are ordered: Relevance or Last Modified.
  • Folder - Search only inside this folder, for example /Invoices.
  • File Name Only - Choose whether the text is matched against file names only.
  • File Categories - Return only files of these kinds, for example images or PDFs.
  • File Extensions - Return only files with these extensions, for example pdf or docx.

Get Folder Contents

Retrieves the files and folders inside a folder. Dropbox - Get Folder Contents action
  1. Path - The folder to list. Select it from the list, or map its path from an earlier step, for example /Invoices. If you leave it empty, the top level of your Dropbox is listed.
  2. Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).
  3. Add Filter - Click Add Filter to define conditions that narrow down the data list and return only the relevant items. To learn more about using filters, click here.
All of the following are optional and are chosen through Add Filter:
  • Recursive - Choose whether to include the contents of all subfolders.
  • Include deleted - Choose whether to also return files and folders that were deleted.
  • Include Has Explicit Shared Members - Choose whether each item tells if it has been shared with specific people.
  • Include Media Info - Choose whether photos and videos come with their media details, such as the time they were taken.
  • Include Mounted Folders - Choose whether to also return shared folders that are mounted in your Dropbox.
  • Include Non Downloadable Files - Choose whether to also return files that can’t be downloaded, such as some online documents.

Move Folder Or File

Moves a file or a folder to a new location. Dropbox - Move Folder Or File action
  1. From Path - The file or folder to move. Select it from the list, or map its path from an earlier step.
  2. To Path - The full path of the new location, including the name the item will have, for example /Archive/report.pdf.
  3. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Allow Ownership Transfer - Choose whether Dropbox may transfer the ownership of the item when the move needs it.
  • Allow Shared Folder - Choose whether a shared folder can be moved.
  • Autorename - Choose whether Dropbox gives the item a different name when the name is already taken, instead of failing.

Rename File or Folder

Renames a file or a folder. The item stays in the same folder. Dropbox - Rename File or Folder action
  1. File Or Folder - The item to rename. Select it from the list, or map its path from an earlier step.
  2. New Name - The new name, for example report-final.pdf. For a file, include its extension.

Restore File

Restores a file to one of its earlier versions. Dropbox - Restore File action
  1. Path - The file to restore. Select it from the list, or map its path from an earlier step.
  2. Revision - The Id of the earlier version to restore. Map it from a Get File Revisions step.

Update File Request

Updates an existing file request. Dropbox - Update File Request action
  1. Id - The file request to update. Select it from the list, or map an Id from an earlier step.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Title - A new name for the file request.
  • Destination - A new folder where the uploaded files are saved.
  • Open - Choose whether the file request accepts uploads.
  • Deadline - Deadline - The date and time when the file request stops accepting uploads.
  • Deadline - Allow Late Uploads - Choose whether people can still upload after the deadline.
  • Deadline Type - Choose Change deadline to apply the deadline you set, or Keep current deadline to leave the existing one as it is. The default is Keep current deadline. The placeholder reads “Change or keep the deadline”.
Updates the settings of an existing shared link. Dropbox - Update Share Link action
  1. URL - The shared link to update. Map it from an earlier step, for example from Create Share Link, or paste the link itself.
  2. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Remove Expiration - Choose Yes to remove the expiration date of the link.
  • Settings - The new settings of the link: Access, Audience and Allow Download. Choose a value for each one you want to change. Access can be Max, Default, Editor or Viewer.

Upload File

Uploads a file to a folder in your Dropbox. Dropbox - Upload File action
  1. Folder Path - The folder to upload the file into. Dropbox adds the File Name (field 4) to this path, so enter only the folder, for example /Reports. Select it from the list, or map its path from an earlier step.
  2. Content - The content of the file as a base64 string. Map it from an earlier step that returns a file, such as an email attachment or Download File.
  3. Mode - What to do if a file with the same name already exists. Choose add, overwrite or update.
  4. File Name - The name the file gets in Dropbox, including its extension, for example report.pdf.
  5. Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
All of the following are optional and are added through Add Field:
  • Autorename - Choose whether Dropbox gives the file a different name when the name is already taken, instead of failing.
  • Mute - Choose whether to skip the notification that Dropbox sends about the new file.
  • Strict Conflict - Choose whether a conflict with an existing file is treated more strictly as an error.

Send API Request

This activity allows you to send a custom API request directly to Dropbox’s API. Dropbox - Send API Request action
  1. Base Url - The root URL of the Dropbox API. It is filled in from your Dropbox connection and can’t be edited here.
  2. Relative url - You can specify additional path segments or parameters that need to be added to the end of the Base Url. This allows you to customize the specific request you want to perform.
  3. Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
  4. Body Type - Defines the format of the data in the body of your request. The default, application/json, means the body contains a JSON-formatted payload.
    • application/json – Sends the request body in JSON format. Commonly used by REST APIs.
    • custom – Allows you to define a custom body format by manually setting the Content-Type header. Add a Content-Type row in Add Headers with the media type you need (for example application/xml). With any other Body Type, a Content-Type you type in Add Headers is not sent; Engini sets it from the Body Type, and the run history shows it under headersnotsent.
    • application/x-www-form-urlencoded – Sends the body as URL-encoded key-value pairs, commonly used in form submissions.
    • file – Sends a file as the request body.
    • multipart/form-data – Sends form data that may include both text fields and files.
    • text/html – Sends the request body as HTML content.
    • text/plain – Sends the request body as plain text.
    • text/xml – Sends the request body in XML format.
  5. Body - Contains any data that is being sent to the server.
  6. Add Headers - Additional metadata about the request, such as the type of data Engini can accept, the length of the request body, and authentication information.
  7. Add Queries - The query refers to the parameters or data that are included in the URL of an HTTP request to provide additional information or instructions to the server.
For the full list of endpoints, see the Dropbox API reference.