Configure Microsoft OneDrive
At a glance
Microsoft OneDrive is a cloud file storage service integrated with Microsoft 365. With Ontologie, you can sync your files, folders, shared items, and recent activity into your workspace.
Before you start
- A Microsoft account (personal or Microsoft 365) with access to the OneDrive you want to sync
- An app registration in Azure Active Directory with the Microsoft Graph API permissions
Get credentials
- Go to the Azure Portal and navigate to Azure Active Directory > App registrations.
- Click New registration, give it a name, and set the redirect URI to the Ontologie callback URL.
- Under API permissions, add Microsoft Graph > Files.Read (or Files.Read.All for shared drives).
- Go to Certificates & secrets, create a new client secret, and copy the value.
Screenshots of the Azure Portal will be added in a future update.
Configure in Ontologie
- Open Live Data > Connectors.
- Search for Microsoft OneDrive in the catalogue.
- Click the Microsoft OneDrive card.
- Follow the configuration wizard:
- Method: OAuth
- See the full guide: OAuth Connector
Available streams
| Stream | Description |
|---|---|
| Files | All files stored in OneDrive, including metadata and content type |
| Folders | Folder hierarchy and structure |
| Shared Items | Files and folders shared with the authenticated user |
| Recent | Recently accessed or modified items |
Limits
| Limit | Value |
|---|---|
| API throttling | Varies by tenant; typically 10,000 requests per 10 minutes |
| File size for metadata sync | No limit (metadata only) |
| SharePoint sites | Supported with additional Graph API permissions |
Troubleshooting
| Error | Solution |
|---|---|
| 401 Unauthorized | Re-authenticate the connector or verify the client secret has not expired. |
| Insufficient privileges | Ensure the app registration has the required Microsoft Graph permissions and admin consent has been granted. |
| Missing shared files | Check that the Files.Read.All permission is granted for access to shared items. |
Expected result
Your data appears in Live Data > Streams with the Synced status. Synchronization runs at the configured frequency.
Need help?
See the Troubleshooting page for connection errors or write to us: Support and contact.