Dropbox
Overview
Dropbox is a cloud storage and file sharing platform for individuals and teams. Integrate with Dropbox to enable file access, sharing, and document management within Suger.
Org-Level vs User-Level
Org-Level: Uses OAuth to connect your organization’s Dropbox Business account. Provides access to team files and member data.
User-Level: Uses OAuth to connect your personal Dropbox account. Provides access to your individual files and folders.
Create Integration (Org-Level)
Prerequisites
- Dropbox Business account with admin access
- Permission to authorize third-party apps
Authenticate by OAuth
- Navigate to Settings > Integrations
- Click Connect Dropbox
- You will be redirected to Dropbox to authorize
- Log in and grant Suger access to your organization’s Dropbox
- Return to Suger — the integration status will show Created
- Click Verify to confirm the connection
The org-level integration requires the following Dropbox scopes:
files.metadata.read,files.content.read,files.content.writesharing.write,account_info.readteam_data.member,team_info.read
Create User Integration
- Click Connect Now in the User Integrations section
- You will be redirected to Dropbox to authorize
- Grant Suger access to your personal Dropbox files
- Return to Suger to confirm the connection
- Click Verify to confirm
Suger AI Tools
When Dropbox is connected, the Suger AI agent can work with your files through Suger’s built-in tools. The user connection exposes the full set (33 actions); the org (team) connection is a smaller, read-oriented subset for browsing and downloading within team folders.
Org-level and user-level: Both are supported; user-level takes precedence when both are connected.
| Capability | What the agent can do | Level |
|---|---|---|
| File & folder operations | Upload, download, copy, move, delete, and read metadata (e.g. upload-file, download-file, move-file-or-folder) | User (download & metadata also on org) |
| Batch operations | Bulk copy, move, delete, and create with async status polling (e.g. batch-copy-files-or-folders, check-batch-move-files-or-folders) | User |
| Sharing | Manage shared links and shared folders (e.g. create-shared-link, share-folder) | User |
| Browse, search & revisions | List folders, search, and manage revisions and temporary/zip links (e.g. list-folder, search-files-and-folders, list-file-revisions) | User (list & download on org) |
| Team folders | List team folders on the Dropbox Business account (e.g. list-team-folders) | Org |
| Account & team admin | Read the connected account and provision team users on Business (e.g. get-account, create-user, delete-user) | User / Org |
Edit Integration
Editing is not supported. Delete and recreate.
Delete Integration
Deleting removes the integration and revokes stored credentials from Suger.