Connect Dropbox

Dropbox uses OAuth2 sign-in. You first create an app in the Dropbox App Console, then connect from Odoo with one click.

Step 1: Create an app in the Dropbox App Console

  1. Go to the Dropbox App Console and click Create app.

  2. Choose Scoped access and the access type your team needs (App folder for an isolated folder, or Full Dropbox).

  3. On the app’s Permissions tab, enable the following scopes:

    account_info.read, files.metadata.read, files.metadata.write, files.content.read, files.content.write

    Warning

    Enable all the scopes above. If you add one later, click Generate Access Token again to re-approve the app.

    Scopes selected on the Permissions tab of the Dropbox App Console

  4. On the Settings tab:

    • Leave the Redirect URIs field for now. You fill it in in Step 3.

    • Copy the App key (Client ID) and App secret (Client Secret).

Dropbox App Console Settings tab with the App key and App secret

Tip

The Required Permissions field shows the permissions needed. If any permission is missing after sign-in, the provider will not connect.

Step 2: Create the provider in Odoo

  1. Navigate to Cloud Storage ‣ Configuration ‣ Providers and click New.

  2. Set a friendly Name (e.g. DropBox) and choose Dropbox as the Provider Type.

  3. Open the Credentials tab and fill in the Client ID (App key) and Client Secret (App secret) from Step 1.

  4. Save the record. The status bar stays on Not Connected until you finish Step 4.

Step 3: Redirect URI

Redirect URIs field in the Dropbox App Console

  1. Copy the Redirect URI from the provider form with the clipboard icon.

  2. In your Dropbox app, add it under Settings ‣ OAuth 2 ‣ Redirect URIs and click Add.

Warning

Paste the exact value, with no trailing slash, before Step 4. A mismatch is the most common cause of a failed sign-in.

Step 4: Connect and test

  1. On the Credentials tab, click Generate Access Token. Odoo saves the Client ID and Client Secret, then sends you to the Dropbox sign-in page.

    Generate Access Token on the Credentials tab of the Dropbox provider

  2. Dropbox first asks you to confirm the developer of the app. Click Continue.

    Dropbox asking you to confirm the app developer before connecting

    Note

    This warning appears because your Dropbox app is still in Development status and has only a few linked users. It is your own app, so it is safe to continue.

  3. Dropbox then lists the permissions the app is asking for. Check that they match the scopes from Step 1 and click Allow.

    Dropbox permission request with the Allow button

  4. Dropbox sends you back to the provider form and Odoo stores the access token. The Connect and Test Connection buttons now appear in the header.

    Connect and Test Connection buttons on the Dropbox provider form

  5. Click Test Connection and verify that the success message appears.

  6. Click Connect to activate the provider. The status moves from Not Connected to Connected.

    Connected Dropbox provider in Odoo showing the storage gauge and Token Expiry

Note

Access tokens are renewed automatically. You only need to reconnect if you revoke the app access in Dropbox or change the Client ID or Client Secret in Odoo.

Step 5: Webhook Configurations

  • What webhooks do

    • Webhooks allow Dropbox to instantly inform Odoo when something happens in your Dropbox (a file or folder added, renamed, moved, or deleted).

    • This means Odoo updates automatically without waiting for the scheduled actions.

    • It helps keep your documents in sync in real time.

  • How to enable or disable

    1. Open your Dropbox provider.

    2. Open the Webhook tab.

    3. Enable Active on the event lines you want, and save.

    4. The Dropbox Webhook URL now appears. Copy it, paste it into your Dropbox App Console under Settings ‣ Webhooks ‣ Webhook URIs and click Add.

      Webhook URI added and enabled in the Dropbox App Console

Warning

The Dropbox Webhook URL contains a secret. Do not share it online or paste it anywhere other than your own Dropbox App Console.

Dropbox Webhook URL and events on the provider form

Webhook Event Types

  • Create/Update Record

    • Triggered when a file or folder is added or modified in Dropbox.

    • Odoo automatically creates or updates the matching document or directory.

  • Delete Record

    • Triggered when a file or folder is deleted in Dropbox.

    • Odoo removes the matching document or directory.

Note

  • Your Odoo URL must use https://. Webhooks will not work on localhost or an intranet.

  • The provider must be in Connected state.

See also