n8n-nodes-dropbox-oauth

A custom n8n community node for Dropbox integration with OAuth 2.0 authentication and automatic token refresh.

Features

• OAuth 2.0 Authentication: Seamless integration with Dropbox using OAuth 2.0
• Automatic Token Refresh: Built-in token refresh handling - no manual re-authentication needed
• Complete Dropbox API Operations:
  • List files and folders
  • Download files (base64 or buffer format)
  • Upload files
  • Get file/folder metadata
  • Create folders
  • Delete files and folders
• Cloudflare OAuth Handler: Uses dedicated OAuth handler service for secure token management
• Error Handling: Comprehensive error handling with continue-on-fail support

Prerequisites

1. OAuth Handler Service: This node requires the Cloudflare OAuth handler deployed at https://oauth.advancedfleetwashing.services
2. Dropbox App: A Dropbox application configured with proper OAuth callbacks
3. n8n Instance: n8n v1.0+ with community nodes support

Installation

Method 1: Local Installation (Development)

cd n8n-nodes-dropbox-oauth
npm install
npm run build
npm run install-local

Method 2: Direct npm install (if published)

npm install n8n-nodes-dropbox-oauth

Authentication Setup

1. Initial Authentication:

   • Visit https://oauth.advancedfleetwashing.services
   • Complete the Dropbox OAuth flow
   • Tokens are automatically stored and managed

2. n8n Credentials Configuration:

   • In n8n, create new "Dropbox OAuth API" credentials
   • Set OAuth Handler URL: https://oauth.advancedfleetwashing.services
   • Test the connection

Usage Examples

List Files in Root Folder

{
  "operation": "listFiles",
  "folderPath": "",
  "includeMediaInfo": true
}

Download a File

{
  "operation": "downloadFile", 
  "filePath": "/Photos/vacation.jpg",
  "returnFormat": "base64"
}

Upload a File

{
  "operation": "uploadFile",
  "uploadPath": "/uploads/document.pdf", 
  "fileContent": "{{$base64_data}}",
  "overwrite": true
}

Supported Operations

| Operation | Description | Parameters | |-----------|-------------|------------| | listFiles | List files in folder | folderPath, includeMediaInfo | | downloadFile | Download file content | filePath, returnFormat | | uploadFile | Upload file to Dropbox | uploadPath, fileContent, overwrite | | getFileInfo | Get file metadata | path | | createFolder | Create new folder | newFolderPath | | delete | Delete file/folder | deletePath |

OAuth Handler Architecture

n8n Workflow → Custom Node → Cloudflare OAuth Handler → Dropbox API
                                      ↓
                           KV Storage (Token Management)

Benefits:

• ✅ Automatic token refresh
• ✅ Secure token storage
• ✅ No tunnel/SSL complexity
• ✅ Production-ready infrastructure
• ✅ No 4-hour re-authentication needed

Error Handling

The node includes comprehensive error handling:

• Token Refresh Failures: Automatic retry with user guidance
• API Rate Limits: Proper error messaging
• Network Issues: Timeout and connection error handling
• Continue on Fail: Optional error propagation control

Development

Project Structure

n8n-nodes-dropbox-oauth/
├── nodes/
│   └── DropboxOAuth/
│       └── DropboxOAuth.node.ts
├── credentials/
│   └── DropboxOAuthApi/
│       └── DropboxOAuthApi.credentials.ts
├── package.json
├── tsconfig.json
└── README.md

Build Commands

npm run build        # Compile TypeScript
npm run dev          # Watch mode
npm run pack         # Build and package
npm run install-local # Install globally for testing

Troubleshooting

"No valid access token available"

• Re-visit the OAuth handler URL to re-authenticate
• Check if the OAuth handler service is running
• Verify Dropbox app configuration

"Network connection failed"

• Verify internet connection
• Check if Dropbox API is accessible
• Ensure OAuth handler service is reachable

"Build errors during installation"

• Ensure TypeScript is installed: npm install -g typescript
• Check n8n-workflow version compatibility
• Clear node_modules and reinstall

Contributing

1. Fork the repository
2. Create feature branch: git checkout -b feature/new-feature
3. Commit changes: git commit -am 'Add new feature'
4. Push to branch: git push origin feature/new-feature
5. Create Pull Request

License

MIT License - see LICENSE file for details.

Support

For issues and questions:

• GitHub Issues: Create an issue
• Email: [email protected]

Built for Advanced Fleet Washing automation workflows 🚛💧