Modernizing Microsoft Bookings: New Graph API Resource Types, Properties, and Entra ID Integration

WHAT JUST CHANGED

Microsoft Bookings has received a significant update via the Microsoft Graph API, rolling out June 2024 (GA for all tenants with Microsoft 365 Business or Enterprise licensing using Bookings). The following new types and properties are now available:

• bookingPageAccessControl enumeration type
• bookingsServiceAvailabilityType enumeration type
• bookingPageSettings resource type
• bookingsAvailability resource type
• bookingsAvailabilityWindow resource type
• customAvailabilities property on bookingSchedulingPolicy
• generalAvailability property on bookingSchedulingPolicy
• isMeetingInviteToCustomersEnabled property on bookingSchedulingPolicy
• appointmentLabel property on bookingAppointment
• customerEmailAddress property on bookingAppointment
• customerName property on bookingAppointment

All Microsoft 365 tenants using Bookings are affected. Admins with delegated permissions (Bookings administrator, Entra Global/Privileged Role Administrator) should review API and UX changes now.

WHAT’S NEXT ON THE ROADMAP

Microsoft has signaled further investment in Bookings and its integration with Entra ID and Microsoft Graph:

• External Booking Integration: Upcoming support for B2B/B2C guest users, allowing external participants to book and manage appointments securely via Entra External Identities.
• Conditional Access for Bookings: Conditional Access policies for Bookings page access and booking actions, currently in private preview, will soon move to public preview.
• PowerShell/Graph Automation: Bookings management via new Microsoft.Graph.Bookings PowerShell cmdlets is scheduled for late 2024. Prepare for policy-based automation across Bookings calendars and resources.
• Booking Workflow Enhancements: Custom workflow triggers (notifications, approvals) for Bookings events, leveraging Logic Apps and Power Automate, are in active development.

Start planning your Bookings automation and Conditional Access posture for external bookings. Review your guest settings and prepare your org for workflow-based booking logic.

WHY THIS DIRECTION IS BETTER

This change delivers concrete advantages over the past model:

• Granular Access Control: The new bookingPageAccessControl enables admins to restrict booking page visibility and actions based on user identity, improving privacy and compliance.
• Improved Availability Management: customAvailabilities and bookingsAvailabilityWindow allow flexible scheduling policies, reducing double-booking and optimizing resource utilization.
• Rich Appointment Metadata: appointmentLabel, customerEmailAddress, and customerName enhance integrations with CRM, analytics, and reporting workflows—no more fuzzy matching or manual reconciliation.
• Meeting Invite Automation: isMeetingInviteToCustomersEnabled streamlines calendar invites for customers, reducing missed appointments and improving engagement.
• API-first Management: All new types and properties are surfaced via Microsoft Graph, enabling programmatic management, bulk updates, and custom reporting.

Compared to competing IdPs (Google Workspace, Okta), Microsoft now offers end-to-end lifecycle management for bookings tied directly to Entra ID, with advanced policy controls and automation hooks.

ADJACENT ENTRA ID CHANGES TO KNOW

• Entra External Identities: Recent changes include simplified guest user lifecycle management and policy enforcement for B2B/B2C scenarios—crucial for organizations running public-facing booking pages.
• Conditional Access UX: June 2024 brings a new “Cloud apps” filter in Entra admin center, making it easier to target Bookings for conditional access and MFA enforcement.
• License Enforcement: Microsoft is tightening enforcement of Business Premium and Enterprise licensing for Bookings API access. Review your licensing posture to avoid unexpected service interruptions.

WHAT TO DO (STEP-BY-STEP)

1. Audit Bookings Resources: Inventory your Bookings calendars, scheduling policies, and access controls via Graph API.
2. Review New Properties: Identify which Bookings pages and policies lack the new properties (customAvailabilities, generalAvailability, etc.).
3. Update Conditional Access Policies: Ensure Bookings is covered by appropriate CA policies (MFA, device compliance) especially for external bookings.
4. Monitor Licensing: Verify correct Microsoft 365 licenses for all Bookings users and service accounts.
5. Plan Automation: Prepare for API-driven management—set up delegated permissions and test Graph queries for future workflow integration.

CHECK IT YOURSELF: Bookings Audit PowerShell

Run this script to inventory Bookings resources and report missing new properties. Requires Microsoft.Graph module and delegated permissions. Handles pagination and errors.

# Requires Microsoft.Graph (v2+) module
Connect-MgGraph -Scopes 'Bookings.Read.All','BookingsAppointment.Read.All'

$allBookings = @()
$uri = 'https://graph.microsoft.com/v1.0/solutions/bookingBusinesses'
do {
    $resp = Invoke-MgGraphRequest -Uri $uri -Method GET
    if ($resp.value) { $allBookings += $resp.value }
    $uri = $resp.'@odata.nextLink'
} while ($uri)

foreach ($business in $allBookings) {
    try {
        $policy = Invoke-MgGraphRequest -Uri ("https://graph.microsoft.com/v1.0/solutions/bookingBusinesses/$($business.id)/schedulingPolicy") -Method GET
        Write-Host "Business: $($business.displayName)"
        if (-not $policy.customAvailabilities) { Write-Warning "Missing customAvailabilities" }
        if (-not $policy.generalAvailability) { Write-Warning "Missing generalAvailability" }
        if ($policy.isMeetingInviteToCustomersEnabled -eq $null) { Write-Warning "Missing isMeetingInviteToCustomersEnabled" }
    } catch {
        Write-Error "Failed to fetch schedulingPolicy for $($business.displayName): $_"
    }
}

PORTAL PATH

To review Bookings settings in Entra admin center:

• Go to Microsoft Entra admin center > Applications > Enterprise applications > Microsoft Bookings
• View Conditional Access policies targeting Bookings
• For business-specific settings: Bookings admin center > Booking page > Scheduling policies

BOTTOM LINE

1. Prioritize: Audit Bookings resources for new property adoption. Update scheduling policy and access controls.
2. Secure: Ensure Conditional Access covers external bookings and public pages.
3. Prepare: Plan for API-first management, automation, and upcoming B2B workflows.
4. Monitor: Review licensing and compliance for all Bookings users and service accounts.

These changes deliver granular control, improved automation, and pave the way for secure, scalable booking workflows tied directly to Entra ID identity lifecycle management.