Outlook Secrets
What this setting does
The Outlook Secrets setting connects Content Manager to your Microsoft 365 organization by storing your Azure Tenant ID. This tells Content Manager which Azure Active Directory tenant to authenticate against when reading calendar data from your Microsoft 365 mailboxes.
This is a district-wide setting — you only need to create it once. It applies to all sites and all Outlook calendar integrations across your organization.
Before you begin
This step assumes that your IT admin has already registered an application in the Azure Portal and sent the Application ID and Client Secret to Imagine Everything. If that has not been done yet, refer to the Outlook Calendar Integration setup guide and complete Stage 1 first.
You will need:
- Your Azure Tenant ID (see below for where to find it)
- Admin access to Content Manager
Where to find your Azure Tenant ID
Your Tenant ID is a unique identifier for your Microsoft 365 organization in Azure Active Directory. It is a UUID in the format xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
You can find it here:
1
Sign in to the
Azure Portal.
2
Go to Azure Active Directory → Overview.
3
Your Directory (tenant) ID is displayed on this page. Copy it.
If you do not have access to the Azure Portal, ask your IT admin or whoever registered the Content Manager application in Azure — they will have noted the Tenant ID as part of that process.
Steps
1
In Content Manager, navigate to Admin → Settings.
2
Click Create Settings.
3
Set the Name to something identifiable, such as Outlook Secrets.
4
Set the Type to Outlook Secrets.
5
In the Azure Tenant ID field, enter the Directory (tenant) ID you copied from the Azure Portal.
6
Leave Sites blank — this setting applies district-wide.
7
Click Save.
What the form looks like
Azure Tenant ID *
a1b2c3d4-e5f6-7890-abcd-ef1234567890
Found in Azure Portal → Azure Active Directory → Overview → Directory (tenant) ID
Using one secret for multiple calendar integrations
A single Outlook Secrets setting can support any number of calendar integrations across your organization. You do not need a new secret for each mailbox or site — the same Tenant ID is used for all of them.
To connect additional calendars after your secret is saved, create a new Outlook setting (not a new Secrets setting) for each calendar you want to connect.
You can create multiple Outlook Secrets settings if your organization needs them — for example, if different schools or departments operate under different Azure tenants. However, for most organizations a single secret is all that is needed.
What happens next
Once this setting is saved, Content Manager can authenticate with Microsoft 365 and read calendar data from your organization's mailboxes. You can now connect individual Outlook calendars to specific sites by creating an Outlook setting for each one.
If you have not done that yet, see Connecting an Outlook calendar to a site.
Troubleshooting
I don't know my Azure Tenant ID
Sign in to the
Azure Portal and go to
Azure Active Directory → Overview. Your Directory (tenant) ID is displayed on this page. If you do not have Azure Portal access, ask your IT admin.
Calendar events are not appearing after saving
Confirm that the Tenant ID is correct and that Imagine Everything has added the Application ID and Client Secret to Content Manager's app configuration. If Stage 1 of the setup has not been completed, the integration will not work regardless of what is entered here.
I need to update the Tenant ID
Edit the Outlook Secrets setting and update the Azure Tenant ID field. This will affect all Outlook calendar integrations across your organization, so confirm the new Tenant ID is correct before saving.