Skip to Content

MC338988: REST API for On-Premises Mailboxes Preview Ending

Upcoming, we will be retiring the preview program enabling REST API access to on-premises mailboxes for Hybrid Exchange organizations.

Note: This will impact those who write code against Exchange mailboxes.

MC338988: REST API for On-Premises Mailboxes Preview Ending

Affected Workloads

  • Exchange Online

Key points

  • Timing: Beginning early March 2023, we will begin to return errors for any requests made for mailboxes that remain on-premises.
  • Action: Use Microsoft Graph for Exchange Online and Exchange Web Services (EWS) for Exchange Server on-premises
  • Roll-out: tenant level

How this will affect your organization


What API(s) should I use to work with Hybrid Orgs, where some mailboxes are in Exchange Online, and some are on Exchange Server?

  • You should continue to use Microsoft Graph to work with Exchange Online mailboxes and use EWS to work with Exchange Server (on-premises) mailboxes.

Wasn’t EWS going away?

  • In 2018 we announced EWS in Exchange Online would no longer receive feature updates. But we have no plans currently to change the way EWS works on-premises, so using Microsoft Graph for Exchange Online and EWS for Exchange Server on-premises is the current recommendation.
  • If you choose to continue using EWS against Exchange Online mailboxes, you should ensure that it uses OAuth (as Basic Authentication is being turned off in Exchange Online). You should also know that it now allows restricting access to mailboxes access through mailbox access policies. Authenticate an EWS application by using OAuth.
  • Application Access Policy Support in EWS

Where can I get help on using Microsoft Graph?

One of the best places to start is Use the Microsoft Graph API and one of the best resources you can use to get practical is Use Graph Explorer to try Microsoft Graph APIs.

Learn more

Message ID: MC338988
Published: 04 March 2022
Updated: 04 March 2022
Major Change: True
#Retirement #Exchange
Plan For Change

    Ads Blocker Image Powered by Code Help Pro

    It looks like you are using an adblocker.

    Ads keep our content free. Please consider supporting us by allowing ads on