Skip to content

How to Setup Dropbox

Jump to bottom
James edited this page Aug 15, 2026 · 1 revision

Upload a build to a folder on Dropbox, optionally creating a public share link you can paste into a Slack or Discord message.

!NOTE: The Dropbox service is marked Experimental. It works, but expect rough edges.

Where things get saved

  • Edit->Preferences->Build Uploader->Services->Dropbox holds your access token. Saved to your own PC only and never written into your project. Every person on your team enters their own.
  • Project Settings->Build Uploader->Services->Dropbox holds app names and folder paths. Saved to <YourProjectPath>/BuildUploader/ and safe to commit so your team shares them.

Create the entry in Project Settings, then enter its secret in Preferences. The Name is what links the two - it must match exactly.

1. Create a Dropbox app and get a token

  • Go to the Dropbox App Console
    • (Or press the App Console button at the top of the Preferences page)
  • Press Create app
    • Choose an API: Scoped access
    • Choose the type of access:
      • App folder keeps the Build Uploader locked to one folder inside your Dropbox. Recommended
      • Full Dropbox lets it write anywhere
    • Give it a name and press Create app
  • Give it permission to upload
    • Go to the Permissions tab
    • Tick files.content.write
    • Tick sharing.write as well if you want the Create Shared Link option
    • Press Submit at the bottom
  • Get the token
    • Go back to the Settings tab
    • Scroll to OAuth 2->Generated access token and press Generate
    • Copy the token

!IMPORTANT: Set the permissions before generating the token. A token generated first will not have the new permissions and uploads will fail with a missing_scope error - you'd have to generate a fresh one.

!NOTE: Dropbox generated access tokens are short lived by default (about 4 hours). If your uploads start failing with a 401 you need to generate a new one. Setting Access token expiration to No expiration in the Settings tab - if your app type offers it - avoids this.

2. Setup Preferences: Edit->Preferences->Build Uploader->Services->Dropbox

  • Turn on Enabled
  • Under Apps press + to create a new App
    • Name: anything you like. This is just a label so you can pick it in a dropdown later. eg: Build Uploader
    • Token: paste the access token from step 1
      • Tick Show if you want to see what you pasted

3. Setup Project Settings: Project Settings->Build Uploader->Services->Dropbox

Add the App

  • Under Apps press +
  • Enter the exact same Name you used in Preferences

Add the folder you want to upload to

  • Under Folders press +
    • Name: anything you like. eg: Nightly Builds
    • Path: the folder path, starting with a /. eg: /Builds
  • Leave the path blank (or the Folder unset in the destination) to upload to the root

!NOTE: If you chose App folder access in step 1, paths are relative to your app's own folder - not the root of your Dropbox. /Builds means Apps/YourAppName/Builds as seen in the Dropbox website.

The folder does not have to exist first - Dropbox creates it on the first upload.

4. Use it in an Upload Config

  • Go to Window->Build Uploader->Open Window
  • Add a Dropbox destination to your Upload Config
    • App: the App you made
    • Folder: the Folder you made (or leave unset for the root)
    • File Name: what the file will be called on Dropbox. Comes pre-filled with a sensible default
    • Zip Contents: leave this on if your source is a folder. It zips the folder and uploads one file
      • Turn it off to upload each top level file separately. Sub folders are skipped when off
    • Create Shared Link: turn on to generate a public link to the uploaded file
      • Needs the sharing.write permission from step 1
      • The link is available as a {key} afterwards, so you can put it in a Slack or Discord message

After uploading, the share link is available as a {key} to any later destination or action. See String Formatter for its name.

Clone this wiki locally