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.- Sign in to Dropbox and open the App Console.
- Select Create app, choose Scoped access and then Full Dropbox, enter a name for the app and select Create app.
- 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.readandfile_requests.write. - Open the app’s Settings tab. Under Redirect URIs, add this address and select Add:
https://workflowapi.engini.io/api/auth/OAuthRedirectUrl - 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.
Connecting Engini to Dropbox
- Enter your Engini account at https://app.engini.io.
-
Navigate to the Connections page by clicking on Connections in the left sidebar or by clicking here.

-
Click on the “New Integration” option located at the top bar.

-
Choose the Dropbox option from the available applications.

- 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.
Custom OAuth 2.0
This method connects through the Dropbox app you created above, so you must enter its Client Id and Client Secret.
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.
- 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.
- Starting (UTC) - Select the date and time of the first check.
- Recur every - Choose how often Engini checks the folder for new files. The minimum interval is 15 minutes.
- Add time frame - Click Add time frame to limit the checks to certain hours of the day.
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.
- Path - The file or folder to copy. Select it from the list, or map its path from an earlier step.
- To Path - The full path of the copy, including the name it will have, for example
/Archive/report.pdf. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- 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. - Title - The name of the file request, for example
Project documents. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- 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.
- Name - The name of the new folder, for example
Invoices 2026. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- Folder - The folder to save the file in. Select it from the list, or map its path from an earlier step.
- File Name - The name of the file, including its extension, for example
notes.txt. - Text Content - The text to save in the file. You can write it here or map it from an earlier step.
Create Share Link
Creates a shared link for a file or a folder, so people can open it through the link.
- 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. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- 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.
Delete File Or Folder
Deletes a file, or a folder together with everything in it.
- Path - The file or folder to delete. Select it from the list, or map its path from an earlier step.
Delete Share Link
Deletes a shared link, so it stops working. The file or folder itself is not deleted.
- Share Link - The shared link to delete. Map it from an earlier step, for example from Create Share Link, or paste the link itself.
Download File
Gets the content of a file, so later steps can use it.
- 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.
- 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.
- 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.
- 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.
- Path - The file whose versions you want. Select it from the list, or map its path from an earlier step.
- 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.
- Search Text - The text to look for, for example
invoice. - Top N - You can set the maximum number of records Engini will return (default = 100, minimum = 1).
- 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.
- 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
pdfordocx.
Get Folder Contents
Retrieves the files and folders inside a folder.
- 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. - Top N - You can set the maximum number of records Engini will return for the object you chose (default = all records).
- 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.
- 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.
- From Path - The file or folder to move. Select it from the list, or map its path from an earlier step.
- To Path - The full path of the new location, including the name the item will have, for example
/Archive/report.pdf. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- File Or Folder - The item to rename. Select it from the list, or map its path from an earlier step.
- 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.
- Path - The file to restore. Select it from the list, or map its path from an earlier step.
- 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.
- Id - The file request to update. Select it from the list, or map an Id from an earlier step.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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”.
Update Share Link
Updates the settings of an existing shared link.
- URL - The shared link to update. Map it from an earlier step, for example from Create Share Link, or paste the link itself.
- Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- 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. - 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.
- Mode - What to do if a file with the same name already exists. Choose
add,overwriteorupdate. - File Name - The name the file gets in Dropbox, including its extension, for example
report.pdf. - Add Field - Click Add Field to add and populate additional fields for the selected activity. To learn more about managing activity data, click here.
- 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.
- Base Url - The root URL of the Dropbox API. It is filled in from your Dropbox connection and can’t be edited here.
- 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.
- Method - Select the HTTP method (e.g., Get, Post, Put, Delete, Patch). The default is POST.
- 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-Typerow in Add Headers with the media type you need (for exampleapplication/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 underheadersnotsent. - 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.
- Body - Contains any data that is being sent to the server.
- 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.
- 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.