MASACP v1.0.4
MASACP Docs

Connecting Dropbox for Automated Cloud Backups

5 min read • Last updated: Oct 25, 2026

Configure dedicated Dropbox API credentials, establish an auto-renewing offline refresh token connection, and automate off-site backup archiving with zero token expiration hassles in MASACP.

1. Overview and the Long-Lived Token Architecture

Modern cloud security standards deployed by Dropbox enforce short-lived access tokens that automatically expire every four hours (14,400 seconds). Using manually generated tokens for recurring server backups inevitably leads to scheduled job failures as soon as the initial token lifecycle lapses.

MASACP solves this challenge at the kernel level by implementing an enterprise OAuth 2.0 offline authorization handshake:

  • Permanent Refresh Token: MASACP negotiates and securely stores an offline refresh token alongside your dedicated App key and App secret.
  • Silent Background Rotation: Prior to dispatching any manual backup or cron schedule, the backup daemon checks token validity and silently renews the access token in the background.
  • Zero Third-Party Relays: Files stream directly from your host filesystem to Dropbox’s API endpoints via encrypted TLS channels without transit through intermediary proxy servers.

2. Creating a Scoped App in the Dropbox Developer Console

Begin by creating a dedicated application in your personal or business Dropbox account:

  1. Log in to your Dropbox account and visit the Dropbox App Console.
  2. Click the Create app button on the top right.
  3. Under 1. Choose an API, select Scoped access.
  4. Under 2. Choose the type of access you need, select Full Dropbox (access to files across your account) or App folder depending on your company’s security policies.
  5. Under 3. Name your app, provide a distinct project name (such as masacp or masacp-backups).
  6. Click Create app to initialize your application workspace.
Figure 1: Configuring API type, access level (Full Dropbox), and application name in Dropbox Developer Console.

3. Granting Content Read and Write Scopes

New Dropbox applications default to minimal read-only metadata scopes. For MASACP to upload archives and verify directory contents, you must enable file write and read permissions:

  1. In your app management interface, click on the Permissions tab.
  2. Under the Files and folders scope group, check the following two required permissions:
    • files.content.write: Allows MASACP to upload archive chunks, create folders, and overwrite backup probe files.
    • files.content.read: Allows MASACP to inspect existing backup archives and calculate folder usage.
  3. Scroll to the bottom of the page and click Submit (or Save changes) to register the updated permissions.
Figure 2: Enabling files.content.write and files.content.read permissions in the Permissions tab.

4. Configuring Redirect URIs and Extracting Credentials

Next, configure the OAuth redirect URI and extract the API keys required by MASACP:

  1. Navigate back to the Settings tab of your Dropbox application.
  2. Locate the OAuth 2 section and find the Redirect URIs input field.
  3. Enter the exact redirect endpoint pre-configured in MASACP:
    https://developers.google.com/oauthplayground
  4. Click the Add button next to the input field to save the redirect URI.
Figure 3: Registering the Authorized Redirect URI inside the OAuth 2 Settings panel.

Under the Credentials header in the same Settings tab:

  • Copy the App key (client identification string).
  • Click the reveal app secret link under App secret and copy the confidential secret key.
Figure 4: Copying App key and revealing the App secret from the Credentials section.

5. Executing the OAuth Handshake in MASACP

Open your MASACP control panel and complete the link:

  1. Navigate to Backups > Cloud Storage Settings > select the Dropbox tab.
  2. Paste your Dropbox App Key and Dropbox App Secret into their respective fields.
  3. Under Step 1, click the blue button: Authorize with Dropbox.

A Dropbox authorization popup will launch. Follow the approval prompts:

  • When prompted with Before you connect this app… (developer verification advisory), click Continue.
  • Review the requested permissions (Edit content of your Dropbox files and folders and view basic information) and click Allow.
Figure 5: Bypassing the unverified developer screen by clicking Continue.
Figure 6: Authorizing file and directory management permissions via Allow.

Important Advisory: Single-Use Authorization Code

Upon granting consent, you will be directed to the redirect window displaying an Authorization code: text box.

DO NOT CLICK the blue Exchange authorization code for tokens button in the browser window!

The authorization code is strictly valid for a single exchange. Clicking the exchange button inside the browser will redeem the code prematurely, causing MASACP’s token negotiation request to fail.

Copy the string directly from the Authorization code: field (or copy the entire address from your browser address bar).

Figure 7: Copying the unredeemed authorization code from the Authorization code box.

Return to the MASACP window, paste the code into Step 2: Paste Authorization Code or Redirected URL:, set your remote folder path (default: /MASACP_Backups), and click Save & Link Dropbox Account.

6. Verification and Remote Storage Hierarchy

MASACP immediately exchanges the code with Dropbox’s OAuth server, stores the permanent refresh credentials, provisions probe verification data, and activates the integration.

Under the Connected Accounts tab, Dropbox will appear alongside any existing providers (such as Google Drive) displaying a green Verified badge, active target directory path, and an on-demand Test button.

Figure 8: Connected Accounts tab showing active and verified Dropbox and Google Drive endpoints.

Inside your Dropbox storage under All files > MASACP_Backups, the system automatically structures backup archives into segregated directories:

  • websites: Contains compressed tarballs for all web root directories, virtual host configurations, and application files.
  • databases: Stores gzipped SQL dumps with timestamped versions for point-in-time recovery.
Figure 9: Automated remote directory structure inside Dropbox partitioned into websites and databases.

Your Dropbox integration is now fully operational with auto-renewing credentials. You can select Dropbox as a destination for manual snapshots or automated daily, weekly, and monthly backup schedules.

Documentation Navigation