---
title: Dropbox
description: Forward SAP documents to Dropbox folders. Supports automatic folder creation, conflict resolution with autorename, and Dropbox Business teams.
type: dropbox
use_cases:
  - External partner document sharing
  - Cloud backup for SAP document archives
  - Dropbox Business team file distribution
config_fields:
  - name: folder_path
    type: string
    required: false
    desc: "Destination folder path (e.g. /SAP/Invoices)"
credential_fields:
  - name: app_key
    type: string
    required: true
    desc: "Dropbox App Key"
  - name: app_secret
    type: string
    required: true
    desc: "Dropbox App Secret"
  - name: refresh_token
    type: string
    required: true
    desc: "OAuth 2.0 refresh token"
---

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](https://www.dropbox.com/developers/apps) 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.