Dropbox

Forward SAP documents to Dropbox. FileRelay uses the Dropbox API to upload files, create folders automatically, and handle name conflicts with autorename. Supports both personal Dropbox accounts and Dropbox Business.

Setup

1. Go to the Dropbox App Console and click Create app
2. Choose Scoped access as the API type
3. Select the access type:
   • App folder — restricts access to a dedicated folder under /Apps/YourAppName/
   • Full Dropbox — allows access to any folder (recommended for flexible path targeting)
4. Name the app and click Create app
5. Go to the Permissions tab and enable:
   • files.content.write — upload files
   • files.content.read — verify folder existence
6. Click Submit to save permission changes
7. Go to the Settings tab and copy the App key and App secret
8. Generate a refresh token by completing the OAuth 2.0 authorization flow:
   • Open https://www.dropbox.com/oauth2/authorize?client_id={APP_KEY}&response_type=code&token_access_type=offline
   • Authorize the app and copy the authorization code
   • Exchange the code for a refresh token via the /oauth2/token endpoint using your App Key and App Secret
9. In FileRelay, add a Dropbox destination with the App Key, App Secret, Refresh Token, and optionally a folder path

REPLACE: Screenshot of the Dropbox connector configuration form in FileRelay

How It Works

FileRelay authenticates with the Dropbox API using the OAuth 2.0 refresh token to obtain a short-lived access token. Documents are uploaded to the specified folder path. If a file with the same name already exists, Dropbox's autorename feature appends a suffix to avoid overwrites.

For files larger than 150MB, FileRelay automatically switches to upload sessions with chunked uploads for reliable delivery.

Folder Structure

Documents are uploaded to:

{folder_path}/{subfolder}/{doc_id}.{ext}

• folder_path — the configured path (e.g. /SAP/Invoices), or root (/) if omitted
• subfolder — automatic subfolder based on routing rules (date, repository, or flat)
• doc_id — the SAP document ID
• ext — file extension based on MIME type

Folders are created automatically if they do not exist.

Dropbox Business

For Dropbox Business accounts, the connector operates under the account linked to the refresh token. To work with team-managed folders:

• Ensure the authenticated user has access to the target team folder
• Use the full path as seen from the user's Dropbox root (e.g. /Team Shared Folder/SAP Documents)
• Team admins can view FileRelay uploads in the Dropbox Business admin console audit log

For team-wide access using a single service account, contact Dropbox support about the Team Member File Access scope for your app.

Permissions

Scope	Purpose
files.content.write	Upload files and create folders
files.content.read	Verify folder existence before upload

Tips

• App folder vs Full Dropbox — If you chose "App folder" during app creation, all paths are relative to /Apps/YourAppName/. Choose "Full Dropbox" if you need to write to arbitrary locations.
• Path format — Dropbox paths must start with a forward slash (e.g. /SAP/Invoices). FileRelay normalizes paths automatically if the leading slash is missing.
• Autorename — When a file with the same name exists, Dropbox appends (1), (2), etc. This prevents accidental overwrites. SAP document IDs are typically unique, so conflicts are rare.
• Shared folders — Files uploaded to shared folders are immediately visible to all folder members. This makes the Dropbox connector ideal for sharing SAP documents with external partners who already have Dropbox.
• Rate limits — Dropbox applies rate limits per app. For high-volume SAP environments, FileRelay queues uploads and retries automatically on 429 (Too Many Requests) responses.
• Token longevity — Refresh tokens do not expire unless the user revokes access or the app is deleted from the Dropbox App Console. No maintenance is needed for long-running integrations.
• File size limits — Dropbox supports files up to 350GB for Business accounts and 50GB for Basic/Plus. SAP documents are well within these limits.