Dropbox Integration

Pull files and watch folders in Dropbox

Use Dropbox as a source for transcripts, proposals, and one-pagers. FastFollow ingests files automatically when watched folders change.

Open integrationsDropbox OAuth docs

Setup walkthrough

~10 minutes

1

Create a Dropbox app

At dropbox.com/developers/apps → Create app. Pick "Scoped access" and "Full Dropbox" (or "App folder" if you want sandboxed access).

  • App name: must be globally unique on Dropbox (e.g. "FastFollow-acme")
  • Permission type: Scoped access (modern OAuth)
  • Access type: Full Dropbox for cross-folder reach, or App folder for isolation
2

Configure permissions and OAuth

Under Permissions, enable the scopes FastFollow needs. Under Settings → OAuth, add the redirect URI.

  • files.metadata.read — list files and folders
  • files.content.read — download file contents (transcripts, proposals)
  • sharing.read — read shared link metadata
  • Redirect URI: https://app.fastfollow.ai/api/integrations/dropbox/callback
3

Set up the webhook

Under Webhooks, register the FastFollow endpoint so we know when files change.

  • Webhook URL: https://app.fastfollow.ai/api/webhooks/dropbox
  • Dropbox sends a verification challenge — FastFollow responds automatically
  • Notifications fire when any watched folder changes
4

Authorize from FastFollow

Copy the App key and App secret into FastFollow → Integrations → Dropbox, then complete OAuth.

  • Refresh tokens are long-lived; rotate by reconnecting
  • For multi-user teams, each user connects their own Dropbox

App folder vs Full Dropbox

For tighter scope, choose "App folder" when creating the Dropbox app. FastFollow will only have access to a single folder (e.g. /Apps/FastFollow/). For cross-organization access, "Full Dropbox" is required — but is also more invasive. Pick based on your trust model.

Troubleshooting

The most common Dropbox errors

invalid_access_token

API calls fail with 401 after some time.

Fix: Token expired or revoked. Dropbox tokens last 4 hours; FastFollow refreshes automatically. If refresh fails, the user must reconnect from FastFollow.

webhook_verification_failed

Dropbox cannot register the webhook.

Fix: The FastFollow webhook endpoint must respond to a GET challenge with the exact echo token. This is automatic in FastFollow but can fail if a reverse proxy strips query params.

insufficient_permissions

Listing succeeds but downloads fail with 403.

Fix: files.content.read scope was not granted. Add it in your Dropbox app permissions, then reconnect from FastFollow.

Still stuck? Contact support