Skip to content
Nappai Documentation

Dropbox Component Folder

This component helps you manage files and folders directly in your Dropbox account from within the Nappai dashboard. It acts as a bridge between your automation workflow and Dropbox, allowing you to automatically upload, download, list, or share folders and files. You simply tell the component what you want to do, provide the necessary folder details, and let Nappai handle the rest. It automatically connects to your Dropbox account securely, so you do not need to manually enter passwords or tokens every time.

How it Works

Internally, this component connects to the Dropbox API to read, write, or share data in your cloud storage. When you place it in your workflow, it first checks which action you selected. It then uses the folder path, file identifiers, or sharing details you provided to perform the task. The component automatically retrieves your secure login information from Nappai’s credential manager, runs the operation, and returns a summary of what was processed. If something goes wrong, it captures the details so you can easily fix the issue in the next step of your workflow.

Connection & Credentials

This component requires configuring a credential in the Nappai panel before interacting with the external service:

  1. Go to the Credentials section in your Nappai panel.
  2. Create a new credential of the type Dropbox API and fill in the required fields (API Key, API Secret, and Access Token). You can generate these in the Dropbox App Console.
  3. In your workflow, select the saved credential in the Credential input field of this node.

Once configured, you can reuse this credential across multiple workflows without re-entering your login details.

Inputs

Input Fields

  • Mode of Input: Choose how the component identifies folders. Options include using all folders (up to a limit of 100 files), by specific ID, by filename, by selection, or by URL.
  • Folder Id: Enter the unique ID of a specific folder. If left blank, the component will use your root Dropbox folder by default.
  • Select folder: Use this to manually browse and choose a folder from your Dropbox account.
  • Operation: Select the main action you want the component to perform (e.g., upload, download, list, or share).
  • Folder Path: Enter the exact path where you want to create or target a folder (e.g., ‘/MyNewFolder’ or ‘/Projects/NewFolder’).
  • Emails to Share With: Enter a comma-separated list of email addresses to grant access to the folder.
  • Folder Name: Enter the name you want to give to a newly created folder.
  • Access Level: Choose the permission level for people you are sharing the folder with.
  • Allow Editing: Toggle this on if you want recipients to be able to edit files within the shared folder.
  • Custom Message: Add a personalized message that will be included in the sharing invitation email.

Outputs

When the component finishes processing, it returns a structured data package containing the results of your action. This output includes the operation status, details of processed files or folders, generated sharing links (if applicable), and any error messages if something failed. You can connect this output to subsequent nodes to trigger further actions, send notifications, or store the results for reporting.

Output Data Example (JSON)json

{ “status”: “success”, “processed_files”: [ “/Projects/AnnualReport.pdf”, “/Projects/BudgetData.xlsx” ], “share_links”: { “/Projects/AnnualReport.pdf”: “https://www.dropbox.com/s/abc123/AnnualReport.pdf?dl=0” }, “error_details”: null }

Connectivity

This component typically connects to other workflow nodes that handle data transformation, file storage, or notification systems. For example, its output can be routed to a File Manager node to organize files further, or to an Email or Messaging notifier to alert your team about shared folders. Because it outputs structured data, it pairs well with any node that accepts JSON or data lists for conditional branching, logging, or triggering downstream automation steps.

Usage Example

Imagine you want to automate sharing a client folder with new team members. You would drag this component into your dashboard, set Mode of Input to ‘By Id’, enter the folder ID, select ‘share’ in the Operation field, provide the Folder Path, and list the team emails in Emails to Share With. Toggle Allow Editing on if they need to modify files. When executed, the component will securely access your Dropbox, generate shareable links, and return the results so you can verify the sharing was successful or pass the links to a notification node.

Tips and Best Practices

  • Always verify folder paths match your Dropbox structure to avoid missing file errors.
  • Use the Mode of Input dropdown wisely: ‘All folders’ has a limit of 100 files per execution to ensure smooth performance.
  • Keep your Dropbox API credential updated if your account credentials change.
  • Use Allow Editing judiciously; restrict editing when sharing sensitive client data.
  • When debugging, check the output status field first to quickly identify if an upload or share failed.

Security Considerations

This component uses secure, encrypted credential management from Nappai. Your Dropbox access tokens and API keys are never exposed in workflow data or logs. The component operates under the permissions granted in your Dropbox App Console, so it is recommended to use the minimum required access level. Always review sharing permissions carefully to prevent unauthorized access to sensitive files.