Outlook Calendar Integration

Content Manager can automatically import events from Microsoft 365 (Outlook) calendars and publish them on your sites. This guide covers everything you need to do — both on the Microsoft 365 side and inside Content Manager — to get the integration up and running.

The integration is read-only. Content Manager will never create, edit, or delete events in Outlook.

Overview

Setup happens in three stages:

Stage 1 — Microsoft 365 setup

This stage is completed by an IT admin with access to the Azure Portal. It only needs to be done once for your entire organization.

Step 1 — Register an application in Azure

1. 1
   Sign in to the Azure Portal with a Microsoft 365 admin account.
2. 2
   Go to Azure Active Directory → App registrations → New registration.
3. 3
   Give the application a name (e.g. Content Manager), leave the default settings, and click Register.
4. 4
   On the application overview page, copy and note down the Application (client) ID and the Directory (tenant) ID — you will need both.

Step 2 — Create a client secret

1. 1
   In the app registration, go to Certificates & secrets → New client secret.
2. 2
   Add a description and choose an expiry, then click Add.
3. 3
   Copy the secret Value immediately — it will not be shown again after you leave this page.

Step 3 — Grant calendar permissions

1. 1
   In the app registration, go to API permissions → Add a permission → Microsoft Graph → Application permissions.
2. 2
   Search for and add Calendars.Read.
3. 3
   Click Grant admin consent to approve the permission for your organization.

Step 4 — Send details to Imagine Everything

Send the following to Imagine Everything so they can complete the configuration on their end:

• The Application (client) ID from Step 1
• The Client Secret value from Step 2

Stage 2 — Configure Outlook Secrets in Content Manager

Before connecting any calendars, a Content Manager admin needs to configure the Outlook Secrets setting with your Azure Tenant ID. This is a district-wide setting that only needs to be done once.

Stage 3 — Connect a calendar to a site

Once Outlook Secrets is configured, you can connect specific calendars to individual sites. You will need the email address of the Microsoft 365 mailbox you want to import from, and optionally the name of a specific calendar within that mailbox.

Finding your mailbox email and calendar name

• Mailbox email — this is the email address of the Microsoft 365 mailbox you want to import from. It could be a shared mailbox (e.g. events@yourschool.org), a resource calendar, or a user's mailbox. Check with your IT admin if you are unsure which mailbox to use.
• Calendar name — if the mailbox has multiple calendars and you only want to import one, you will need its name exactly as it appears in Outlook (e.g. School Events). If you leave this blank, Content Manager will import from all calendars in the mailbox.

Creating the setting

1. 1
   In Content Manager, navigate to Admin → Settings.
2. 2
   Click Create Settings.
3. 3
   Set the Name to something identifiable, such as the name of the site or calendar (e.g. Lincoln Elementary Events).
4. 4
   Set the Type to Outlook.
5. 5
   In the Mailbox Email field, enter the email address of the Microsoft 365 mailbox to import from.
6. 6
   In the Calendar Name field, enter the name of a specific calendar if you want to limit the import to one calendar. Leave this blank to import from all calendars in the mailbox.
7. 7
   Under Sites, select the site this calendar should be connected to.
8. 8
   Click Save.

What the form looks like

Connecting multiple calendars

One Outlook Secrets setting can support any number of calendar integrations across your organization. You do not need a new secret for each calendar or site — the secret is shared across all of them.

To connect additional calendars, simply create a new Outlook setting (not a new Secrets setting) for each one. Each Outlook setting can point to a different mailbox and calendar.

Troubleshooting