MC338988 U Exchange Online, SharePoint Development Services
From Microsoft Corporation
Technical Bulletin MC338988 · Published Mar 4, 2022 · Last updated Mar 14, 2023
Message Summary
Updated March 14, 2023: We have updated the timing of this change. Thank you for your patience.
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.
Key points
- Timing: Beginning early June (previously early March), 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:
FAQ:
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.
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:
