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

    Your Support Matters...

    We run an independent site that\'s committed to delivering valuable content, but it comes with its challenges. Many of our readers use ad blockers, causing our advertising revenue to decline. Unlike some websites, we haven\'t implemented paywalls to restrict access. Your support can make a significant difference. If you find this website useful and choose to support us, it would greatly secure our future. We appreciate your help. If you\'re currently using an ad blocker, please consider disabling it for our site. Thank you for your understanding and support.