Connecting Outlook Calendar
Guide to enable “Discover” calendar integration on your organisation’s Outlook Calendar
Boomerang - Microsoft 365 Integration Guide
Overview
Boomerang leverages the Microsoft Graph API to integrate with your Microsoft 365 environment. This integration requires organization-wide (application-level) permissions, which must be approved by an Azure Active Directory (Azure AD) administrator.
Why is this Integration Necessary?
Boomerang uses the Microsoft Graph API for the following key functionalities:
- Fetching Calendar Events: Retrieving calendar events across all users within your organization.
- User Profile and Directory Information: Accessing user profiles and directory data.
- Group Memberships: Reading group memberships for accurate account mapping.
These operations necessitate application-level permissions that an Azure AD administrator must grant.
Integration Steps:
1. App permissions requested
To authorize Boomerang to access your Microsoft 365 environment, an Azure AD administrator must grant consent.
- Sign in using an Azure AD administrator account.
- Review the "Permissions requested" screen (as shown below) and approve the requested permissions.
- Below is a list of all permissions currently required for “Discover” to sync events from your calendar
Permission Name | Description |
Calendars.Read | Read calendars in all mailboxes |
Calendars.ReadBasic.All | Read basic calendar info in all mailboxes |
Directory.Read.All | Read organization’s directory data |
Group.Read.All | Read all Microsoft 365 groups |
User.Read.All | Read full profiles of all users |
User.ReadBasic.All | Read basic profile info of all users |
People.Read.All | Read a list of relevant people for all users |
MailboxSettings.Read | Read mailbox settings (e.g., timezone, work hours, automatic replies) |
2. Configure on Boomerang App
1→ Visit Boomerang website Discover page

2→ Login into your account and you should be able to see the Discovery integration page. Click on connect below “Outlook Calendar”


3→ You should be redirected to a Microsoft login page where you can select the Azure Admin account

4 → Review the permissions requested by the app and click on “Accept”

5 → Once the loading is completed, you should be able to see a screen with the message “Outlook App installed successfully”

6 → Go back to the Boomerang website discover page and you should be able to see settings for Boomerang Discover listed out.

7 → Once settings are configured, you can use the Groups and Users tabs to select people within your teams that you intend to track the calendars for. Reach out to our team if you’re unable to view the users and groups even after connecting Outlook.
All Done! 🙂
By following the steps outlined in this guide, you can enable a secure and effective calendar integration. This integration will help you gain insights from your team's calendar data, identify hidden customers, and enhance your customer engagement strategy.
For further assistance, please contact our support team (mail : support@getboomerang.ai).