Skip to main content

Overview

Buckle connects AI agents to Dropbox through OAuth. Agents can browse files and folders, download and upload content, and manage sharing. The gateway injects OAuth credentials into requests to the Dropbox API automatically.

What you will set up

  • A Dropbox connection through OAuth, with read access by default and optional write access
  • Automatic token injection on requests to the Dropbox API
  • Per-agent, per-tool access to files and sharing

Setup

1

Open the app

Open the Buckle dashboard and navigate to Settings > Apps > Dropbox.
2

Authorize

Click Connect Dropbox. You’ll be redirected to Dropbox to authorize Buckle. Review the requested permissions and click Allow.
Buckle connect window for Dropbox on Cloud, showing the Connect to Dropbox button.

The Dropbox connect window on Buckle Cloud.

Buckle requests read access to account info, file metadata, and file content by default. Write access for uploading, organizing, and sharing is optional.
3

Verify

After authorization, you’ll be redirected back to the dashboard. The connection will show as Connected with your Dropbox email.

What agents can do

Use cases

  • Document processing agents that read files from Dropbox and extract information
  • Backup agents that upload generated reports or exports
  • File organization agents that sort and rename files based on content
  • Collaboration agents that share files and manage folder permissions

Self-hosted: use your own Dropbox app

Skip this section on Buckle Cloud. It’s only for self-hosted Buckle without DROPBOX_CLIENT_ID and DROPBOX_CLIENT_SECRET set, or if you want your own company name on Dropbox’s consent screen.

1. Create the Dropbox app

Go to the Dropbox App Console and select Create app. Choose Scoped access and Full Dropbox, name it (for example Buckle-yourcompany), and create it.
Open Permissions, tick these, and select Submit:account_info.read, files.metadata.read, files.content.read, files.content.write, sharing.read, sharing.write
Dropbox app named Buckle on the Permissions tab, with account_info.read, files.content.read, and files.content.write ticked.

The Permissions tab of your Dropbox app, with the file scopes ticked.

In Buckle, open Settings > Apps > Dropbox > Custom credentials and copy the Redirect URI. In Dropbox, open Settings, paste it into OAuth 2 > Redirect URIs, and select Add.
Buckle Custom credentials card for Dropbox with the setup guide link, the Redirect URI and its copy button, and the client ID and secret fields.

Copy the Redirect URI from Custom credentials in Buckle.

Dropbox app Settings, OAuth 2 section, with https://buckle.example.com/v1/apps/dropbox/callback under Redirect URIs.

The OAuth 2 section of your Dropbox app's Settings tab, with the Buckle Redirect URI.

On the Dropbox Settings tab, copy the App key and App secret. Paste both into Settings > Apps > Dropbox > Custom credentials, select Save credentials, then Connect and allow access in Dropbox.

Controlling access

Access is per agent: grant the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization rules add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Dropbox.

FAQ

Yes. Buckle requests read access by default, and write access is optional. You can also grant only the read tools to a specific agent.
No. The token stays in Buckle, and the gateway adds it to Dropbox API requests at the proxy. See How it works.
Yes. Set sharing and delete tools to need approval when you grant the connection, or add organization rules.
Open Settings > Apps > Dropbox and connect again. Agents with access use the new connection automatically.