Dropbox

Connect & Ingest data from Dropbox

Dropbox is a cloud storage and file hosting service. The Sling Dropbox connector extracts data from the Dropbox API v2, supporting files and folders listing, shared links, shared folders, received files, file requests, and account information.

circle-check

Setup

The following credentials and inputs are accepted:

Secrets:

  • client_id (required) -> Your Dropbox app key

  • client_secret (required) -> Your Dropbox app secret

  • refresh_token (required) -> A long-lived OAuth2 refresh token

Getting Your Credentials

  1. Click Create app

  2. Choose Scoped access and Full Dropbox access type

  3. Name your app and click Create app

  4. Under the Permissions tab, enable these scopes:

    • account_info.read

    • files.metadata.read

    • sharing.read

    • file_requests.read

  5. Click Submit to save permissions

  6. Under the Settings tab, note the App key (client_id) and App secret (client_secret)

  7. Generate a refresh token using the OAuth2 authorization flow:

The response will contain a refresh_token — save this value for your connection configuration.

Using sling conns

Environment Variable

See here to learn more about the .env.sling file.

Sling Env File YAML

See here to learn more about the sling env.yaml file.

Replication

Here's an example replication configuration to sync Dropbox data to a PostgreSQL database:

Sync all endpoints:

Endpoints

Account

Endpoint
Description
Incremental

current_account

Current user account information

No

Files & Folders

Endpoint
Description
Incremental

files

All files and folders (recursive)

No

Sharing

Endpoint
Description
Incremental

shared_links

All shared links

No

shared_folders

Shared folders the user has access to

No

received_files

Files shared with the current user

No

File Requests

Endpoint
Description
Incremental

file_requests

File requests created by the user

No

To discover available endpoints:

Rate Limiting

The Dropbox API enforces rate limits on a per-app and per-user basis. The connector automatically:

  • Limits to 5 requests/second (conservative)

  • Retries with exponential backoff on 429 (rate limit) responses

  • Retries on 5xx server errors with exponential backoff

Notes

  • All Dropbox API v2 endpoints use POST requests internally, even for read operations. The connector handles this automatically.

  • The files endpoint lists all files and folders recursively from the root of the Dropbox account, including mounted folders.

  • The shared_folders and received_files endpoints may return empty results if the account has no shared content.

If you are facing issues connecting, please reach out to us at [email protected]envelope, on discordarrow-up-right or open a Github Issue herearrow-up-right.

Last updated

Was this helpful?