Microsoft 365

Connect OneDrive, SharePoint, Outlook, and Teams to Ballast.

Connect your Microsoft 365 applications to index documents, emails, and team conversations.

Available Integrations

IntegrationFeatures
OneDrivePersonal and shared folders
SharePointSites and document libraries
OutlookCombined mail and calendar
Outlook MailEmail-only indexing
Outlook CalendarCalendar-only indexing
Microsoft TeamsChannel messages and files
ExcelWorkbook indexing
WordDocument indexing
OneNoteNotebook and section indexing

Setup

All Microsoft integrations use Azure AD OAuth:

  1. Add the integration to your collection
  2. Click Connect with Microsoft
  3. Sign in with your Microsoft account
  4. Authorize the requested permissions
  5. Configure sync settings

OneDrive

Index files from OneDrive:

  • Personal - Your OneDrive (connect as personal source)
  • Shared - OneDrive for Business shared folders

Configuration

OptionDescription
FoldersSelect specific folders
File typesFilter by document type
Include sharedInclude shared files

SharePoint

Index SharePoint sites and document libraries:

  • Select which sites to include
  • Choose specific document libraries
  • Index list items with metadata

Best Practices

  • Start with specific sites rather than all sites
  • Use document libraries for file-heavy content
  • Consider sync frequency for large libraries

Outlook

Index emails and calendar events:

  • Outlook - Both mail and calendar
  • Outlook Mail - Email only
  • Outlook Calendar - Calendar only

Connect as a personal source to keep emails private.

Configuration

OptionDescription
FoldersInbox, Sent, custom folders
Date rangeHow far back to index
Include attachmentsExtract text from attachments

Microsoft Teams

Index Teams conversations:

  • Channel messages
  • Files shared in channels
  • Meeting notes

What’s Indexed

  • Public channel messages
  • Files in channel folders
  • Meeting transcripts (if available)

What’s Not Indexed

  • Private chats (unless connected as personal source)
  • Video/audio content

Excel & Word

Index Office documents:

  • Full text extraction
  • Table data from Excel
  • Document structure preserved

OneNote

Index notebooks:

  • Section and page content
  • Embedded images (with OCR on Pro)
  • Ink-to-text (limited support)

Sync Behavior

TypeDefault Frequency
OneDriveEvery 15 minutes
SharePointEvery hour
OutlookEvery 15 minutes
TeamsEvery 15 minutes

Required Permissions

Ballast requests:

  • Files.Read.All - Read OneDrive/SharePoint files
  • Mail.Read - Read Outlook emails
  • Calendars.Read - Read calendar events
  • ChannelMessage.Read.All - Read Teams messages