> ## Documentation Index
> Fetch the complete documentation index at: https://docs.statusstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft 365 & Azure AD Integration

> Connect StatusStack to Microsoft Partner Center to automatically discover GDAP client tenants and monitor Microsoft 365 service health

## Overview

The Microsoft 365 integration allows MSPs to connect their Microsoft Partner Center account to StatusStack. Once connected, StatusStack automatically discovers all your GDAP (Granular Delegated Admin Privileges) client tenants and can monitor Microsoft 365 service health for each client.

Navigate to **Settings** → **Microsoft 365** in the MSP Console.

***

## What This Integration Does

* **GDAP Tenant Discovery** — Automatically import all your Microsoft Partner Center client tenants
* **M365 Service Health Monitoring** — Monitor Microsoft 365 service health for each client tenant (Exchange, Teams, SharePoint, etc.)
* **Auto-Import** — Discovered tenants can be automatically mapped to StatusStack client organizations
* **StatusStack Widget** — Microsoft integration status appears on your MSP Dashboard

***

## Setup

### Step 1: Connect Microsoft Partner Center

Two connection options are available:

**Option A: Enterprise App Setup (Recommended)**

The enterprise app method grants StatusStack access via a Microsoft Entra ID enterprise application, enabling automatic GDAP tenant discovery.

1. Click **Set Up Microsoft Integration** on the Microsoft 365 page
2. Select **Enterprise App Setup**
3. Follow the Microsoft OAuth flow to grant admin consent
4. After completing the OAuth flow, StatusStack automatically starts syncing your GDAP tenants

**Option B: Standard OAuth**

A simpler connection for basic Microsoft 365 authentication. Use this if you don't need GDAP tenant auto-discovery.

1. Click **Set Up Microsoft Integration**
2. Select **Standard OAuth**
3. Complete the Microsoft sign-in flow

***

### Step 2: Sync GDAP Tenants

After connecting, sync your GDAP tenants from Microsoft Partner Center:

1. Click **Sync GDAP Tenants** on the Microsoft 365 page
2. Confirm the sync in the modal — this discovers all client tenants from your Partner Center account
3. Wait a few moments for the sync to complete
4. Discovered tenants appear in the tenant list below

<Note>
  If you used the Enterprise App Setup, tenant sync begins automatically after the OAuth flow completes — you don't need to click Sync manually for the initial import.
</Note>

***

### Step 3: Map Tenants to Clients

Discovered tenants need to be mapped to your StatusStack client organizations. When unmapped tenants are detected, a **Map Tenants** button appears at the top of the page.

**Mapping Options:**

* **Auto-create clients** — Automatically create new StatusStack client organizations for each tenant
* **Map to existing clients** — Match each tenant to an existing client organization you've already created

You can also enable Microsoft 365 service health monitoring immediately during the mapping step.

***

## Microsoft 365 Service Health Monitoring

Once tenants are mapped, StatusStack can monitor Microsoft 365 service health for each client. Service health is pulled from the Microsoft Service Communications API.

**What's monitored:**

* Exchange Online
* Microsoft Teams
* SharePoint Online
* OneDrive for Business
* Microsoft 365 Admin Center
* Azure Active Directory
* Other M365 services as reported by Microsoft

Status updates reflect the official Microsoft service health status and appear in the client's monitoring dashboard alongside their other services.

***

## Managing the Connection

### Connection Settings

Click **Connection Settings** on the Microsoft 365 page to:

* View the current connection status and token expiry
* Reconnect if the token has expired
* Disconnect the integration

### Token Expiry

Microsoft OAuth tokens expire periodically. The MSP Dashboard's **Microsoft Integration widget** shows the connection status and alerts you if a re-authentication is needed. Click **Connection Settings** → **Reconnect** to refresh the token.

### Re-syncing Tenants

Run a tenant sync at any time by clicking **Sync GDAP Tenants**. This picks up any new tenants added to your Partner Center account since the last sync.

***

## PSA & RMM Integrations

In addition to Microsoft 365, the MSP Console supports connecting PSA (Professional Services Automation) and RMM tools via the **Integrations** page under Settings.

Navigate to **Settings** → **Integrations** to add integrations. The integration manager uses a plugin system — available providers appear in the **Integration Provider** dropdown when creating a new integration.

Integration types include:

* **PSA** — Professional Services Automation (for creating tickets via [Automations](/guides/msp-automations))
* **RMM** — Remote Monitoring & Management tools
* **Webhook** — Custom webhook integrations

***

## Related Guides

* [MSP Automations](/guides/msp-automations) — Automatically create PSA tickets on incidents
* [Client Management](/guides/msp-client-management)
* [MSP Console Overview](/guides/msp-setup)