New ‘Capacity’ Property in Microsoft Graph Virtual Event Town Hall & Session Resources: What Entra Admins Need to Know

WHAT JUST CHANGED

Microsoft has added a new capacity property to the town hall and virtualEventSession resources in Microsoft Graph. This change is currently available in Public Preview as of June 2024. All Entra tenants with Microsoft Teams or Microsoft 365 workloads using Graph API for event management are affected, especially organizations leveraging Town Hall or Virtual Event Sessions for large-scale communications.

• Feature Name: “capacity” property for virtualEventTownHall and virtualEventSession resources
• Effective Date: June 2024 (Public Preview)
• Rollout Status: Public Preview
• Tenants Affected: All Entra tenants using Microsoft Graph for Town Hall and Virtual Event Session management

WHAT’S NEXT ON THE ROADMAP

Microsoft is doubling down on cloud communications with upcoming features for event lifecycle automation, granular access controls, and deeper integration with Entra External ID for B2B/B2C guest management. Next on the roadmap:

• Event Lifecycle Management (ELM): Automated workflows for event creation, attendee registration, and post-event reporting via Graph API.
• Role-Based Access for Sessions: Assign organizers, presenters, and guests granular permissions for each session, tied to Entra roles.
• External ID Integration: Streamlined guest invitations and external user lifecycle management, leveraging new B2B/B2C APIs.
• Conditional Access for Event Join: Policy-based control for event attendance, including MFA and device compliance requirements.
• Reporting Enhancements: Bulk export of event attendance, capacity analytics, and compliance reporting via Graph and PowerShell.

WHY THIS DIRECTION IS BETTER

The new capacity property enables admins to set, audit, and enforce attendee limits for Town Hall and Virtual Event Sessions. Previously, capacity management was manual or not exposed via API, leading to compliance risks and overbooking. With this model:

• Improved Compliance: Set hard limits aligned to licensing and regulatory requirements.
• Automation Ready: API-driven capacity checks empower automated workflows, reducing manual errors.
• Better Analytics: Capacity-based metrics improve reporting, forecasting, and post-event analysis.
• Competitive Edge: Entra ID’s event API now matches or exceeds features from Zoom, Webex, and Google Meet, with direct integration to identity and access policies.
• Unified Experience: Admins can manage event capacity alongside Conditional Access, External ID, and lifecycle controls from one platform.

ADJACENT ENTRA CHANGES TO WATCH

• Entra External ID Guest Lifecycle: New APIs for guest invitation, approval, and removal, tied to event participation policies.
• Conditional Access for Teams Live Events: Recent updates allow policies to be scoped to event join URLs, enforcing MFA and device controls.
• Microsoft Graph Change Tracking: Improved delta query support for event resources, enabling real-time monitoring of attendee, guest, and capacity changes.
• Operational Licensing Checks: Licensing APIs now support validation for Town Hall and Session creation, helping admins avoid over-allocating events beyond purchased seats.

WHAT TO DO: STEP-BY-STEP ADMIN ACTIONS

1. Review Usage: Inventory all Town Hall and Virtual Event Sessions via Microsoft Graph to check if capacity is set.
2. Set Capacity: Update event resources to enforce attendee limits based on business, compliance, and licensing constraints.
3. Audit Permissions: Ensure only authorized users can modify event capacity, using Entra role assignments.
4. Integrate Conditional Access: Tie event join links to Conditional Access policies for enhanced security.
5. Monitor and Report: Use PowerShell to regularly audit event capacity and alert on overbooking or missing limits.

CHECK IT YOURSELF: POWERSHELL AUDIT

Inventory All Town Hall and Sessions with Capacity Data:

# Requires Microsoft.Graph module >= 2.0
# Connect with least privilege (Event.Read.All)
Connect-MgGraph -Scopes "Event.Read.All"

function Get-MgVirtualEventsCapacity {
    $townhalls = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/beta/communications/virtualEvents/townhalls" -ErrorAction Stop
    $sessions = Invoke-MgGraphRequest -Method GET -Uri "https://graph.microsoft.com/beta/communications/virtualEvents/sessions" -ErrorAction Stop
    $allCapacity = @()
    foreach ($th in $townhalls.value) {
        $allCapacity += [PSCustomObject]@{
            Type = 'TownHall'
            Id = $th.id
            Name = $th.displayName
            Capacity = $th.capacity
        }
    }
    foreach ($sess in $sessions.value) {
        $allCapacity += [PSCustomObject]@{
            Type = 'Session'
            Id = $sess.id
            Name = $sess.displayName
            Capacity = $sess.capacity
        }
    }
    return $allCapacity
}

try {
    $results = Get-MgVirtualEventsCapacity
    if ($results.Count -eq 0) {
        Write-Host "No Town Hall or Session events found."
    } else {
        $results | Format-Table Type, Id, Name, Capacity
    }
} catch {
    Write-Error "Failed to query virtual events: $_"
}

Note: This script uses beta endpoints—verify your tenant supports them and always review permissions before running in production.

PORTAL PATH

• Entra Admin Center: Go to Microsoft Teams Admin Center → Events → Town Hall or Virtual Events. Select an event, then check the Capacity property under Event Details.
• Azure Portal: (If integrated) Navigate to Microsoft Entra ID → Enterprise Applications → Microsoft Teams → Events Management.
• Audit Logs: For changes, use Entra Admin Center → Audit Logs → Activity → Event Capacity Changes.

BOTTOM LINE

• High priority: Audit event capacity settings now, ensure compliance, and prepare for automated lifecycle policies.
• Medium priority: Integrate capacity checks into your event creation workflow and Conditional Access policies.
• Low priority: Monitor roadmap updates for deeper integration with External ID and role-based access controls.

The addition of the capacity property in Microsoft Graph’s virtual event resources gives Entra admins a powerful new lever for compliance, automation, and event management. Act now to ensure your events use this feature and stay ahead of the evolving cloud communications roadmap.