Actions20
Overview
This node operation creates a new folder in a Dropbox account. It is useful when you want to organize files by programmatically adding folders within your Dropbox storage. For example, you might use this node to create project-specific folders automatically when onboarding new clients or to structure backups by date.
Properties
| Name | Meaning |
|---|---|
| Folder Path | Path of the new folder to create (e.g., /new-folder-name). This is a required string input specifying where the new folder will be created in Dropbox. |
Output
The output JSON contains details about the newly created folder under the created_folder field. This includes metadata returned from Dropbox's API about the folder such as its path, ID, and other attributes confirming successful creation.
Example output structure:
{
"resource": "folder",
"operation": "create",
"created_folder": {
// Dropbox API response with folder metadata
}
}
Dependencies
- Requires an OAuth 2.0 authenticated connection to Dropbox via an API key credential.
- The node uses Dropbox API endpoints, specifically
https://api.dropboxapi.com/2/files/create_folder_v2. - Proper OAuth token management is handled internally, including token refresh via an external OAuth handler URL.
Troubleshooting
Common issues:
- Invalid or expired OAuth tokens can cause authentication failures.
- Specifying a folder path that already exists may result in an error or unexpected behavior depending on Dropbox API response.
- Network connectivity issues can prevent API calls from succeeding.
Error messages:
"OAuth token refresh failed"indicates problems refreshing the access token; ensure the OAuth handler service is reachable and configured correctly."Dropbox operation failed: ..."indicates a failure in the Dropbox API call; check the folder path validity and permissions.
Resolutions:
- Verify OAuth credentials and re-authenticate if necessary.
- Confirm the folder path does not conflict with existing folders.
- Check network connectivity and API endpoint accessibility.