Integrating Outlook with Frontegg allows your application to read, send, and manage email messages, organize mail folders, access contacts, and read mailbox settings — all through Frontegg's integration layer using Microsoft OAuth 2.0 and the Microsoft Graph API.
Prerequisites
Prerequisites
- A Microsoft account with access to the Azure portal
- An Azure Active Directory (Microsoft Entra ID) tenant
Sign in to the Azure portal and search for App registrations in the top search bar. Click App registrations in the results, then click New registration.
Fill in the registration form:
- Enter a name for your application (for example,
Frontegg Outlook Integration). - Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant — Multitenant) for multi-tenant apps, or the appropriate option for your use case.
- Under Redirect URI, select Web as the platform and enter:
https://YOUR_MCP_GATEWAY_URL/integration-callback - Click Register.
After registration, you are taken to the application overview page. Copy both the Application (client) ID and the Directory (tenant) ID — you will need them when configuring the Frontegg portal.
In the left sidebar, click Certificates & secrets, then click New client secret.
In the Add a client secret panel, enter a description (for example, Frontegg Integration) and choose an expiry period. Click Add.
The new secret appears in the list. Copy the Value immediately — it is only shown once. After you navigate away, you cannot retrieve it again.
Save your Client Secret now
Save your Client Secret now
The Client Secret value is only displayed once. After you leave this page, you can only see the secret ID — not the value. Store the value securely before continuing.
In the left sidebar, click API permissions, then click Add a permission.
In the Request API permissions panel, click Microsoft Graph, then click Delegated permissions.
Expand the Mail group and select the permissions your application requires. Repeat for Contacts, MailboxSettings, and any other groups you need. When finished, click Add permissions.
Once you have your Client ID, Client Secret, and optionally the Tenant ID, enter them in the Frontegg portal:
- Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Outlook.
- Enter the Client ID and Client Secret in the corresponding fields.
- Optionally, enter the Directory (tenant) ID. Leave blank or use
commonfor multi-tenant applications. - Select the required scopes:
| Scope | Description |
|---|---|
Mail.Read | Read user mail |
Mail.ReadWrite | Read and write access to user mail |
Mail.Send | Send mail as a user |
Mail.Read.Shared | Read user and shared mail |
Mail.ReadWrite.Shared | Read and write user and shared mail |
Mail.Send.Shared | Send mail on behalf of others |
MailboxSettings.Read | Read user mailbox settings |
MailboxSettings.ReadWrite | Read and write user mailbox settings |
MailFolders.Read | Read user mail folders |
MailFolders.ReadWrite | Read and write user mail folders |
Contacts.Read | Read user contacts |
Contacts.ReadWrite | Read and write user contacts |
Contacts.Read.Shared | Read user and shared contacts |
Contacts.ReadWrite.Shared | Read and write user and shared contacts |
User.Read | Sign in and read user profile |
User.ReadBasic.All | Read all users' basic profiles |
- Click Save.
Keep your credentials secure
Keep your credentials secure
Never share or commit your Client Secret to version control.