Dropbox
12 min
learn how to connect engini to dropbox using engini’s dropbox activities, you can upload files, download files, create folders, manage files, and automate your document workflows directly from dropbox to get started with the dropbox app, create a free account at dropbox com or sign in with your existing dropbox account getting started with dropbox prerequisites a dropbox account note make sure to allow the required permissions ( scopes ) in dropbox when connecting your account otherwise, some activities may not work properly add a connection to dropbox in engini enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the topbar choose dropbox option from the available applications enter the details in the “add connection” form note there are two different authentication methods available, and the required fields differ depending on the option you choose please follow the relevant instructions for oauth2 method oauth2 sign in using your account connection name enter unique identifier for the connection within engini authentication method select oauth2 click on the “sign in” button sign into your dropbox account fields automatically populated post connecting to a dropbox account include access token a token for authorization to access google services refresh token a token used to obtain a new access token when the current one expires click on the save button to save the connection actions get all files/subfolders in a folder retrieves all subfolders and files inside a specified dropbox folder this activity allows you to list the contents of a folder so you can use them in the next steps of your workflow path specifies the dropbox folder whose contents you want to retrieve 2 ways to fill it dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" top n limits the number of results returned if left empty, all items are retrieved add filters click add filter to filter more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data get file the get file activity retrieves detailed information about a specific file in dropbox such as its size, creation date, and version id path specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" create file request creates a new dropbox file request so others can upload files to a specific folder in your dropbox destination the dropbox folder where uploaded files will be saved for example "/file requests/project documents" 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" title the name of the file request add field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data delete file request closes a dropbox file request so people can no longer upload files through it ids \[] a list of file request ids you want to close for example \["oacavmeyrqynkzx9955y", "bf93klmpqr2xyz12345", "xt78abcdef456gh789"] note to delete a file request, it must first be closed dropbox does not allow deleting a request while it is still open follow this simple flow create the file request https //help engini ai/dropbox#create file request using the create file request activity update the file request https //help engini ai/dropbox#update file request and set the field open = false to close it delete the file request using the delete file request activity if you try to delete a request that is still open, the api will return the error file request open download file this activity allows you to get the content of a file in your dropbox app path specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" update file request updates the settings of an existing dropbox file request, such as its title, description, or deadline id the unique identifier of the file request you want to update click on the field to open a dynamic list showing all your file requests names from your dropbox account add field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data upload file uploads a file to a specified location in your dropbox account path specifies the dropbox folder whose contents you want to retrieve 3 ways to fill it dynamic list choose through a live, auto generated list of your dropbox folders and subfolders to select one dynamic mapping map a path variable from a previous step in your workflow so it changes automatically based on real time data static text provide a folder path such as "/invoices" content insert the content of the file in as a base64 format file name choose a unique name for this file, make sure you write at the end of the the corresponding file type( e g image png, document pdf ) mode choose from the dropdown list if you want to add a new file , overwrite an existing one or update add field click add field to update more fields of the item to learn more about managing activity data click here https //shared archbee space/public/preview ixqqblwfxopjg0nave78y/preview ycdmxhmvfcwesvtyflkox#managing activity data send api request this activity allows you to send a custom api request directly to dropbox base url – this is the root url of the api you’re sending the request to relative url – you can specify additional path segments or parameters that need to be added to the end of the automatically generated 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) body type – defines the format of the data in the body of your request commonly used values include application/json (as shown), which means the body will contain a json formatted payload body – contains any data that is being sent to the server add headers – additional metadata about the request, such as the type of data the 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