All Tenants

View and manage all connected Microsoft 365 tenants. This page provides a comprehensive list of every customer tenant with status indicators, quick actions, and drill-down capabilities.

Tenant List

The main table displays all connected tenants with the following columns:

Column	Description
Tenant Name	Display name of the Microsoft 365 tenant. Click to enter tenant context.
Domain	Primary domain (e.g., contoso.onmicrosoft.com)
Customer	Associated customer record from your CRM/PSA
Health	Status indicator: Healthy (green), Warning (yellow), Critical (red)
Users	Total licensed users in the tenant
Secure Score	Microsoft Secure Score percentage
Last Sync	When data was last synchronized from Graph API
Actions	Quick actions menu (sync, edit, disconnect)

Filtering and Search

Search — Filter by tenant name, domain, or customer name
Health Filter — Show only Healthy, Warning, or Critical tenants
Tag Filter — Filter by assigned tenant tags
Customer Filter — Show tenants for a specific customer

Row Actions

Each tenant row has a context menu (three dots) with these options:

Enter Tenant — Switch context to manage this specific tenant
Sync Now — Force immediate data synchronization from Graph API
View Health Report — Open detailed health assessment
Edit Settings — Modify tenant display name, tags, or customer association
Reconnect — Re-authenticate if consent has expired
Disconnect — Remove tenant from management (requires confirmation)

Bulk Operations

Select multiple tenants using checkboxes to perform bulk actions:

Bulk Sync — Synchronize all selected tenants
Apply Tags — Add or remove tags from selected tenants
Export — Download tenant list as CSV
Run Report — Generate combined report for selected tenants

API Reference

GET /api/msp-portal/tenants — List all connected tenants with summary data
GET /api/msp-portal/tenants/:tenantId — Get detailed information for a specific tenant
POST /api/msp-portal/tenants/:tenantId/sync — Trigger manual synchronization
DELETE /api/msp-portal/tenants/:tenantId — Disconnect tenant (soft delete, preserves audit history)

Graph API Integration

Tenant data is synchronized using Microsoft Graph API with the following endpoints:

GET /organization — Tenant details
GET /users/$count — User count
GET /subscribedSkus — License information
GET /security/secureScores — Secure Score