Skip to content
Nappai Documentation

Dropbox Component File

This component connects your Nappai automation to your Dropbox account, allowing you to manage files and folders automatically. It helps you read file contents, upload new files, organize your storage, or share documents with team members. The component uses the credentials you have already set up in Nappai, so you do not need to log in or handle passwords every time you run a workflow.

How it Works

Internally, this component communicates securely with the Dropbox API using your project’s saved credentials. When you run a workflow, the component takes the details you provide—such as a file name, folder ID, or file content—and performs the requested action on Dropbox.

It handles all the technical steps for you, including authentication, checking permissions, and managing the data connection. If the operation is successful, the component returns the result or file data, which you can use in later steps. If something goes wrong, it provides information about the error so you can fix the issue.

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. You can find your API key, API Secret, and Token in the App Console of your Dropbox account. Ensure you select the necessary Dropbox Permissions based on the actions you need (e.g., read or write access).
  3. In your workflow, select the saved credential in the Credential input field of this node.

Inputs

Input Fields

  • Operation: Select the type of action you want to perform on your Dropbox files.
  • Mode of Input: Choose how you want to identify the files. Options include “All Folders in Dropbox” (processes up to 100 files), “By Id”, “By Filename”, “By Selection”, and “By Url”.
  • Selection Mode: Determine how to select the files. “Folder” returns all files inside a folder, while “File” selects a specific file.
  • File Id: Enter the unique ID of a file to work with.
  • Select file: Pick a file directly from your selection.
  • Folder Id: [Required] Enter the ID of the folder. This is necessary for many operations.
  • Select folder: Choose a folder. If left empty, the system uses the root folder.
  • Filename: Provide the name of the file. This can be used to create a file or as a filter when getting files.
  • File Content: Upload the data for the file. Note: If the file type is Drive mimeType, use copy or move operations instead.
  • New Name: Specify a new name to rename an existing file.
  • Email: Enter an email address to share the file with a user.
  • Role: Select the role to assign to the shared user.
  • Send Notification: Toggle to send a notification to the user when sharing a file.
  • Download Base64 Content: Check this to include the file content converted to Base64 format when retrieving a file.
  • Process File Content: Check this to have the file content processed into text when retrieving a file.
  • File Type: Filter the results by file type. “Any” returns all files. This is ignored if you select a specific File or provide a File Id.

Outputs

This component produces data that can be used in later steps of your workflow.

  • Data: The result of the operation. Depending on the action, this may contain file information, file content, success status, or error details.

Output Data Example (JSON)json

{ “name”: “contract.pdf”, “path”: “/Documents/contract.pdf”, “size”: 1024, “modified”: “2023-10-27T10:00:00Z”, “id”: “id:a4ayc_80_EEAAAAAAAAAAA”, “shareable_link”: “https://www.dropbox.com/…” }

Connectivity

This component is versatile and can connect to various other nodes depending on your workflow needs.

  • Upstream: Often receives file IDs or folder names from other components that list files or handle triggers.
  • Downstream: Can send data to components that need file content, such as text analyzers, storage savers, or notification senders.

Usage Example

Scenario: Listing and Processing Files

  1. Set Mode of Input to “All Folders in Dropbox” to gather up to 100 files.
  2. Set Selection Mode to “Folder” and provide a Folder Id for the folder you want to check.
  3. Enable Process File Content if you want to read the text inside the files.
  4. The component will return the list of files and their content in the Data output, which you can then use to analyze, summarize, or store in another system.

Tips and Best Practices

  • Use Folders for Efficiency: When working with multiple files, use the “Folder” selection mode and provide a Folder Id to limit the scope of your automation.
  • Handle Errors: Always check the Data output for any potential errors to ensure your file operations completed successfully.
  • Permissions: Ensure your Dropbox API credential has the correct Dropbox Permissions selected in the credential setup to allow read/write access as needed.
  • File Limits: Note that some modes may have limits, such as processing up to 100 files at once. For larger datasets, consider batching your operations.

Security Considerations

  • Secure Credentials: Never share your Dropbox API tokens. Always use the Nappai credential system to manage access securely.
  • Data Privacy: Be mindful of what file content you process. Ensure sensitive data is handled according to your organization’s privacy policies.