Connecting Outlook Calendar – Boomerang

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.

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).