Connect OneDrive

OneDrive uses OAuth2 sign-in. You first register an app in Microsoft Entra, then connect it from Odoo with one click.

Step 1: Register an app in Microsoft Entra

  1. Sign in to the Microsoft Entra admin center and browse to Microsoft Entra ID ‣ App registrations ‣ New registration.

  2. Give the app a name (e.g. Odoo Cloud Documents).

  3. Under Supported account types, choose who can use the app.

  4. Under Redirect URI, choose the Web platform. You fill in the value itself in Step 3.

  5. Select Register. The app’s own Overview page opens. Copy the Application (client) ID and the Directory (tenant) ID from there.

    Application (client) ID and Directory (tenant) ID on the app Overview page

  6. Open Manage ‣ Certificates & secrets ‣ New client secret, create a secret and copy its Value right away. It is shown only once.

    Client secret Value on the Certificates & secrets page

  7. Open Manage ‣ API permissions ‣ Add a permission ‣ Microsoft Graph ‣ Delegated permissions and add:

    offline_access, Files.ReadWrite.All, User.Read
    Microsoft Graph delegated permissions on the API permissions page

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 ‣ Connections ‣ Providers and click New.

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

  3. Open the Credentials tab and fill in:

    • Directory (Tenant) ID: the tenant ID from Step 1.

    • Client ID: the Application (client) ID from Step 1.

    • Client Secret: the secret Value from Step 1.

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

Step 3: Redirect URI

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

  2. In your app registration under Manage ‣ Authentication (Preview), add it as a Web platform redirect URI and click Save.

    Adding a Web platform redirect URI in the Microsoft Entra app registration

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 Microsoft sign-in page.

    Generate Access Token on the Credentials tab of the OneDrive provider

  2. Sign in with the Microsoft account whose OneDrive you want to connect, then review the permissions and click Accept.

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

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

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

    Connected OneDrive provider in Odoo showing the storage gauge

Note

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

Step 5: Webhook Configurations

  • What webhooks do

    • Webhooks allow OneDrive to instantly inform Odoo when something happens in your drive (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 OneDrive provider.

    2. Open the Webhook tab.

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

OneDrive webhook events on the provider form

Webhook Event Types

  • Create/Update Record

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

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

  • Delete Record

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

    • 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