Microsoft 365 Message Center item MC1469565

MC1469565 - Microsoft Purview | Data Lifecycle Management - Graph API Support for archive mailboxes

Microsoft is retiring Exchange Web Services (EWS) in Exchange Online by April 2027 and expanding Microsoft Graph API support for archive mailboxes. Organizations must migrate applications from EWS to Microsoft Graph APIs by October 2026 to maintain archive mailbox access, compliance, eDiscovery, and data lifecycle management.

Message Center ID: MC1469565
Category: plan For Change
Severity: normal
Services: Microsoft Purview
Tags: User impact, Admin impact, Retirement
Roadmap ID: 567313
Platforms: Web
Published: 2026-09-09
Last updated: 2026-09-09
Expires: 2026-12-01
Action required by: 2026-10-01

[What and why]As part of the retirement of Exchange Web Services (EWS) in Exchange Online, Microsoft is expanding support for archive mailbox scenarios through Microsoft Graph APIs.Organizations that currently use EWS to access archive mailbox data should begin migrating to Microsoft Graph APIs before EWS is disabled. Microsoft Graph now provides API support for importing and exporting mailbox data and for managing archive mailbox folders, including support for auto-expanding archives.This change helps ensure continued access to archive mailbox data after EWS is retired and provides a supported path forward for compliance, data lifecycle management, eDiscovery, backup, and related archive mailbox solutions.[Rollout schedule]General Availability (Worldwide): Beginning in late October 2026 and expected to complete by early November 2026Important: Exchange Web Services (EWS) in Exchange Online will begin to be disabled globally in October 2026 and is expected to be fully disabled by April 2027[Impact on your organization]Who is affectedOrganizations that use applications, scripts, or third-party solutions that rely on EWS to access archive mailbox content.Examples include:eDiscovery solutionsCompliance and records management workflowsData lifecycle management solutionsBackup and export toolsCustom applications that access archive mailboxesPlatforms and servicesMicrosoft PurviewExchange OnlineMicrosoft GraphWhat will happenApplications and scripts that continue to use EWS for archive mailbox operations will stop functioning after EWS is disabled.Organizations using auto-expanding archive mailboxes must update applications to support Microsoft Graph archive mailbox behaviors.Microsoft Graph APIs support archive mailbox scenarios through:Mailbox import and export APIsMailboxFolder APIs for folder management operationsApplications may need to handle redirect responses when archive content resides in auxiliary archive mailboxes.[Action required and recommendations]Action required: YesBefore October 2026, we recommend that administrators and developers:Identify applications and scripts that use EWS to access archive mailboxes.Review EWS Usage Reports: https://learn.microsoft.com/microsoft-365/admin/activity-reports/ews-usageReview Microsoft Graph archive mailbox guidance.Review Archive mailbox redirects: https://learn.microsoft.com/graph/handle-archive-mailbox-redirectsUpdate applications to use Microsoft Graph APIs for archive mailbox operations.Review Mailbox import and export overview: https://learn.microsoft.com/graph/mailbox-import-export-concept-overviewUse available migration resources to assess and update existing code.EWS Analyzer and migration tools: https://aka.ms/ewsToolsAI-assisted migration tutorial: https://aka.ms/ewsToolsAITutorialEWS-to-Microsoft Graph API mappings: https://aka.ms/ews2graphMapContact third-party vendors to confirm their plans and timelines for migrating from EWS to Microsoft Graph.Learn moreDeprecation of EWS in Exchange OnlineEWS migration toolsExchange Web Services (EWS) to Microsoft Graph API mappingsHandle archive mailbox redirects in Microsoft GraphOverview of the mailbox import and export APIs in Microsoft Graph https://learn.microsoft.com/graph/mailbox-import-export-concept-overviewTutorial - Migrating from EWS to Microsoft Graph API with GitHub Copilot[Compliance considerations]QuestionAnswerDoes this change modify, interrupt, or disable Purview-related capabilities, including retention, eDiscovery, export, or data lifecycle management workflows?Yes. Organizations using EWS-based integrations for eDiscovery, compliance exports, retention-related processes, or data lifecycle management that access archive mailboxes must migrate to Microsoft Graph APIs before EWS is disabled.Does this change alter how users or applications access, export, or manage Microsoft 365 data?Yes. Applications that access or export archive mailbox data through EWS must be updated to use Microsoft Graph APIs to maintain functionality after EWS retirement.Does this change add or affect third-party integrations?Yes. Third-party applications and services that use EWS to access archive mailbox content may require vendor-provided updates or migration to Microsoft Graph APIs.Does this change affect how organizations demonstrate or maintain compliance processes?Yes. Organizations that rely on EWS-based compliance, auditing, export, or records management workflows for archive mailbox data should review and update their integrations to ensure continuity of compliance operations.