OneDrive Connector
The OneDrive connector syncs files from your personal OneDrive or SharePoint-backed OneDrive (Microsoft 365) into your Hubrix document library.
How to connect
- Go to Settings → Data Connectors (or Settings → Integrations).
- Click Add connector and select OneDrive.
- Click Connect OneDrive.
- You are redirected to Microsoft's OAuth consent screen. Sign in with your Microsoft account.
- Review the permissions Hubrix is requesting and click Accept.
- You are redirected back to Hubrix with the connector active.
After connecting, the Folder Picker opens automatically so you can select which folders to sync.
Permissions requested
Hubrix requests the following Microsoft Graph permission:
| Permission | Why it is needed |
|---|---|
Files.Read.All | Read files and folder contents from your OneDrive |
Hubrix does not request write permissions. It cannot create, modify, or delete any files in your OneDrive.
Files.Read.All allows reading any file accessible to your account, including shared files and SharePoint libraries. Hubrix only reads files in the folders you explicitly select — it does not scan everything accessible.
Incremental sync with Microsoft Graph delta
OneDrive sync uses Microsoft Graph's delta API for incremental syncing. On the first sync, Hubrix downloads all files in your selected folders. On every subsequent sync, the delta API returns only the changes since the last sync — new files, modified files, and deleted files.
This means:
- Subsequent syncs are fast, even for large folders
- Deleted files in OneDrive are removed from your Hubrix library automatically
- Renamed files are updated without requiring a full re-download
Reconnecting after token expiry
Microsoft access tokens expire periodically. When this happens:
- The connector shows a red Error badge.
- Click the connector in Settings → Data Connectors and then Reconnect.
- Complete the Microsoft OAuth flow again.
If your Microsoft 365 admin revokes third-party app authorisations, the connector will stop working until you reconnect. Contact your IT admin if you cannot authorise the connection.
Disconnecting
To disconnect the OneDrive connector:
- Go to Settings → Data Connectors.
- Click the connector and then Disconnect.
- Choose whether to keep or delete the synced documents from your Hubrix library.
Disconnecting revokes Hubrix's access token. Your OneDrive files are not affected.
Was this helpful?