Back to Guides
Integrations

OneDrive Integration Setup

~20 min | Last updated May 14, 2026

Overview

Findable can connect to OneDrive for Business through the same Microsoft Graph-based integration used for SharePoint. OneDrive for Business is technically backed by SharePoint personal sites, so the setup uses the SharePoint connector in Findable with one OneDrive-specific permission change.

Once connected, Findable can monitor selected OneDrive folders and mirror documents into the Findable platform for AI-powered classification, search, and organization.

Use this guide when your source documents live in a user’s OneDrive or in a dedicated Microsoft 365 service account’s OneDrive.

Important: This guide is for OneDrive for Business. Personal consumer OneDrive accounts are not supported.

Before You Start

You’ll need:

  • Microsoft 365 Global Admin access, or help from your IT administrator
  • Administrator access in your Findable organization
  • A OneDrive for Business account whose folders should be synced
  • About 20 minutes

For production setups, we recommend using a dedicated service account such as data@yourcompany.com instead of a personal employee account. If an employee leaves and their OneDrive is deleted, the sync will stop working.

Setup Guide

Step 1: Register the Application in Microsoft Entra

Findable first needs to be registered as a trusted application in your Microsoft tenant.

  1. Sign in to the Microsoft Entra admin center.
  2. Go to Identity → Applications → App registrations → New registration.
  3. Set Name to something clear, for example Findable Integration.
  4. Keep Supported account types set to Accounts in this organizational directory only.
  5. Click Register.
  6. Copy these values from the app overview page:
    • Application (client) ID
    • Directory (tenant) ID

You’ll need both when configuring Findable.

Step 2: Create the Client Secret

The client secret lets Findable authenticate with Microsoft Graph in the background.

  1. In the app registration, open Certificates & secrets.
  2. Click New client secret.
  3. Add a description, for example Findable_Sync_2026.
  4. Choose an expiry period. Most teams use 12 or 24 months.
  5. Click Add.
  6. Copy the secret Value immediately.

Critical: Copy the secret Value, not the Secret ID. Microsoft only shows the value once. Store it securely before leaving the page.

Step 3: Grant Microsoft Graph API Permissions

This is the key difference between SharePoint and OneDrive.

  1. In the app registration, open API permissions.
  2. Click Add a permission.
  3. Select Microsoft Graph.
  4. Select Application permissions. This allows Findable to sync in the background without a user being signed in.
  5. Search for and select Files.Read.All.
  6. Click Add permissions.
  7. Click Grant admin consent for [Your Company].
  8. Confirm that the permission status turns green.

Files.Read.All gives the application read access to files in OneDrive for Business across the tenant. If you also use the same app registration for SharePoint site sync, add Sites.Read.All as well.

Troubleshooting: If you cannot see the admin consent button, your account does not have the required Microsoft 365 admin rights. Ask a Global Admin to complete this step.

Step 4: Connect Findable to Microsoft

Use the SharePoint connector in Findable, even when the source is OneDrive.

  1. Sign in to app.findable.ai with a Findable administrator account.
  2. Navigate to Building Settings → Integrations → SharePoint.
  3. Enter the values from Microsoft Entra:
    • Tenant ID — the Directory (tenant) ID
    • Client ID — the Application (client) ID
    • Client Secret — the secret value copied in Step 2
  4. Click Save.
  5. Click Test to verify the connection.

After the Microsoft connection is working, choose which OneDrive location Findable should sync.

  1. In Findable, open the relevant building.

  2. Click Add Subscription.

  3. Paste the URL for the OneDrive for Business account.

    The URL usually follows this format:

    https://company-my.sharepoint.com/personal/firstname_lastname_company_com

    For example, data@company.com often becomes:

    https://company-my.sharepoint.com/personal/data_company_com

  4. Select the folder to sync, for example /Documents/O&M Manuals.

  5. Click Connect.

Findable will start monitoring that folder and importing supported documents.

Checklist

Before handing this over to Findable, confirm that you have:

  • Copied the Tenant ID
  • Copied the Client ID
  • Saved the client secret Value securely
  • Added the Microsoft Graph application permission Files.Read.All
  • Granted admin consent and confirmed the status is green
  • Identified the OneDrive for Business URL to sync
  • Selected the target folder in Findable

Common Issues

The Microsoft permission status is not green

Admin consent has not been granted. A Microsoft 365 Global Admin needs to open the app registration and click Grant admin consent for [Your Company].

The OneDrive URL does not work

Make sure you are using the OneDrive for Business personal-site URL, not the browser URL for an individual file. It normally starts with:

https://company-my.sharepoint.com/personal/

Sync stops after an employee leaves

If the subscription points to an employee’s personal OneDrive and that account is disabled or deleted, Microsoft may remove access to the files. Use a dedicated service account for long-running integrations.

Need Help?

If you run into issues during setup, contact support@findable.ai or use the chat widget in the bottom-right corner of the Findable app.