Upcoming API Deprecations in Exchange Web Services for Exchange Online
Published Oct 05 2021 10:05 AM 132K Views

Update 1/20/2022: We have edited this post for clarity based on customer feedback.

Over the last few years, we have invested heavily in Microsoft Graph to enable developers to access the rich data available in Microsoft 365. Microsoft Graph, along with OAuth 2.0, provides increased security and seamless integration with other Microsoft cloud services.

In August 2018, we announced that we were no longer going to actively invest in Exchange Web Services (EWS) APIs for Exchange Online. We also gave a strong recommendation to start migrating to Microsoft Graph for Exchange Online data access.

Today we are announcing the deprecation of the 25 least used APIs of EWS for Exchange Online (as determined by the call volume into the service). We are deprecating these APIs to begin the process of reducing the surface area of the EWS protocol for maintenance and security purposes. Support for these APIs will no longer exist after March 31, 2022.

The list of deprecated APIs is at the end of this post. We will introduce sunset headers in the response for these APIs that are marked for deprecation.

We have already sent Message Center posts to tenants using these low volume, and now deprecated APIs. If you did not already receive a Message Center post, you will not be impacted by this change.

Over time, we will identify additional APIs for deprecation when and where we see adequate parity with Microsoft Graph APIs. We are also working hard on addressing feature gaps and building parity between EWS and Microsoft Graph APIs. We strongly urge our ecosystem partners accessing Exchange Online data to migrate to Microsoft Graph APIs.

We previously announced that we planned to prevent registration of new apps in Azure with EWS permissions, but based on your feedback we have decided to postpone this plan for the time being.

EWS is a legacy API surface that has served us well, but no longer meets the security and manageability needs of modern app development. We strongly urge our ecosystem partners accessing Exchange Online data to migrate to Microsoft Graph APIs.

APIs scheduled for deprecation:


The Exchange Team and Microsoft Graph Team

Version history
Last update:
‎Jan 20 2022 01:28 PM
Updated by: