Skip to main content
Connect SharePoint to Realm to make documents and site content searchable. Navigate to Settings > Data sources and click Connect on SharePoint, or click Manage if already connected.

​
Connecting SharePoint

1

Authorize access

Click Authorize on the SharePoint data source page. You’ll be redirected to Microsoft’s OAuth consent screen. Review the permissions and click Accept. This does not start syncing any data yet.
SharePoint data source page showing the two-step connection flow
Microsoft OAuth consent screen requesting SharePoint permissions
2

Select sites and drives

After accepting, you’ll be redirected back to Realm. Select which SharePoint sites and OneDrive drives to sync.
SharePoint data source page showing connected sites and available sites to add
By default, Realm can only access files that the connecting user has access to (delegated scope). To let Realm index all files in SharePoint, you have two options:
  • Grant admin consent in Microsoft Entra (see below)
  • Connect with application scopes using the alternative connect button on the data source page
To allow Realm to access all SharePoint content (not just what the connecting user can see), grant admin consent in Microsoft Entra:
  1. Go to Microsoft Entra admin center > Applications > Enterprise applications
  2. Find Realm in the list
  3. Go to Permissions and click Grant admin consent for [your organization]
Microsoft Entra admin center showing the Grant admin consent button for Realm
Both delegated and application scopes still enforce user-level permissions in search results. The scope only affects what Realm can index.

​
What gets synced

ContentSynced
Documents and files in selected sitesYes
SharePoint site pagesYes
OneNote notebooks and pagesYes
OneDrive files in selected drivesYes
SharePoint listsNo

​
Selecting sites and drives

After connecting, choose which SharePoint sites and OneDrive drives to sync. The data source page shows connected sites and drives, and you can add or remove them at any time. Realm only syncs content from the sites and drives you select.

​
Permissions

Realm enforces SharePoint’s native permission model. Users can only see documents they have access to in SharePoint. You can override this by switching to “Everyone in this organization” on the data source settings page, which makes all synced SharePoint data visible to all Realm users.

​
Restricting API access

To limit what Realm can access:
  1. Create a Microsoft service account that only has access to specific sites
  2. Ensure the account can consent to applications
  3. Use that account when connecting SharePoint

​
Required scopes

The SharePoint integration requires:
  • Sites.Read.All
  • Files.Read.All
  • Directory.Read.All
  • Notes.Read.All