The End of the REST API for On-Premises Mailboxes Preview

Published Mar 04 2022 08:00 AM 18.9K Views

We’re announcing today that the preview program enabling REST API access to on-premises mailboxes for Hybrid Exchange organizations preview program is closing.

A year from now, beginning March 2023, we will begin to return errors for any requests made for mailboxes that remain on-premises.

Since we announced we were making it possible for developers to use REST APIs to work with both cloud and on-premises mailboxes back in 2016, we’ve seen low and now decreasing adoption rates. Primarily because so many of our customers have moved all, or most of their mailboxes into Exchange Online. Moving mailboxes to the cloud is the strategic direction the vast majority of our customers are taking, and so we are aligning our investments accordingly.

What does this mean to those who write code against Exchange mailboxes and are impacted? Here are the most common questions we expect to be asked, but please do add comments below if we have not addressed your concerns.

When will you begin preventing REST API requests from reaching On-Premises Mailboxes?
We will begin to return errors for requests made for mailboxes that remain on-premises from March 2023.

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 Graph to work with Exchange Online mailboxes, and use Exchange Web Services (EWS) to work with Exchange Server (on-premises) mailboxes. 

I thought EWS was going away, though?
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 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 Graph?
One of the best places to start is Use the Microsoft Graph API - Microsoft Graph | Microsoft Docs and one of the best resources you can use to get practical is Use Graph Explorer to try Microsoft Graph APIs - Microsoft Graph | Microsoft Docs

Summary

In closing, we know some of our customers and partners have built solutions based on a preview feature we released some years ago, and we understand that updating code to remove this dependency might be time consuming. However, we need to invest our resources in building highly scalable, secure and robust solutions that both reflect Microsoft’s strategic imperatives and focus on the technologies we see our customers adopting. In this case, it’s Exchange Online.

Exchange Online Team

8 Comments
%3CLINGO-SUB%20id%3D%22lingo-sub-3221219%22%20slang%3D%22en-US%22%3EThe%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3221219%22%20slang%3D%22en-US%22%3E%3CP%3EWe%E2%80%99re%20announcing%20today%20that%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fgraph%2Fhybrid-rest-support%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Epreview%20program%20enabling%20REST%20API%20access%20to%20on-premises%20mailboxes%20for%20Hybrid%20Exchange%20organizations%3C%2FA%3E%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fgraph%2Fhybrid-rest-support%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Epreview%20program%20%3C%2FA%3Eis%20closing.%3C%2FP%3E%0A%3CP%3EA%20year%20from%20now%2C%20beginning%20March%202023%2C%20we%20will%20begin%20to%20return%20errors%20for%20any%20requests%20made%20for%20mailboxes%20that%20remain%20on-premises.%3C%2FP%3E%0A%3CP%3ESince%20we%20announced%20we%20were%20making%20it%20possible%20for%20developers%20to%20use%20REST%20APIs%20to%20work%20with%20both%20cloud%20and%20on-premises%20mailboxes%20back%20in%202016%2C%20we%E2%80%99ve%20seen%20low%20and%20now%20decreasing%20adoption%20rates.%20Primarily%20because%20so%20many%20of%20our%20customers%20have%20moved%20all%2C%20or%20most%20of%20their%20mailboxes%20into%20Exchange%20Online.%20Moving%20mailboxes%20to%20the%20cloud%20is%20the%20strategic%20direction%20the%20vast%20majority%20of%20our%20customers%20are%20taking%2C%20and%20so%20we%20are%20aligning%20our%20investments%20accordingly.%3C%2FP%3E%0A%3CP%3EWhat%20does%20this%20mean%20to%20those%20who%20write%20code%20against%20Exchange%20mailboxes%20and%20are%20impacted%3F%20Here%20are%20the%20most%20common%20questions%20we%20expect%20to%20be%20asked%2C%20but%20please%20do%20add%20comments%20below%20if%20we%20have%20not%20addressed%20your%20concerns.%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3E%3CFONT%20size%3D%224%22%3E%3CEM%3EWhen%20will%20you%20begin%20preventing%20REST%20API%20requests%20from%20reaching%20On-Premises%20Mailboxes%3F%3CBR%20%2F%3E%3C%2FEM%3E%3C%2FFONT%3E%3C%2FSTRONG%3EWe%20will%20begin%20to%20return%20errors%20for%20requests%20made%20for%20mailboxes%20that%20remain%20on-premises%20from%20March%202023.%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3E%3CFONT%20size%3D%224%22%3E%3CEM%3EWhat%20API(s)%20should%20I%20use%20to%20work%20with%20Hybrid%20Orgs%2C%20where%20some%20mailboxes%20are%20in%20Exchange%20Online%2C%20and%20some%20are%20on%20Exchange%20Server%3F%3CBR%20%2F%3E%3C%2FEM%3E%3C%2FFONT%3E%3C%2FSTRONG%3EYou%20should%20continue%20to%20use%20Graph%20to%20work%20with%20Exchange%20Online%20mailboxes%2C%20and%20use%20Exchange%20Web%20Services%20(EWS)%20to%20work%20with%20Exchange%20Server%20(on-premises)%20mailboxes.%26nbsp%3B%3C%2FP%3E%0A%3CP%3E%3CSTRONG%3E%3CFONT%20size%3D%224%22%3E%3CEM%3EI%20thought%20EWS%20was%20going%20away%2C%20though%3F%3CBR%20%2F%3E%3C%2FEM%3E%3C%2FFONT%3E%3C%2FSTRONG%3EIn%202018%20%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fexchange-team-blog%2Fupcoming-changes-to-exchange-web-services-ews-api-for-office-365%2Fba-p%2F608055%22%20target%3D%22_blank%22%3Ewe%20announced%3C%2FA%3E%20EWS%20in%20Exchange%20%3CEM%3EOnline%3C%2FEM%3E%20would%20no%20longer%20receive%20feature%20updates.%20But%20we%20have%20no%20plans%20currently%20to%20change%20the%20way%20EWS%20works%20%3CEM%3Eon-premises%3C%2FEM%3E%2C%20so%20using%20Graph%20for%20Exchange%20Online%20and%20EWS%20for%20Exchange%20Server%20on-premises%20is%20the%20current%20recommendation.%3C%2FP%3E%0A%3CP%3EIf%20you%20choose%20to%20continue%20using%20EWS%20against%20Exchange%20Online%20mailboxes%20you%20should%20ensure%20that%20it%20uses%20OAuth%20(as%20Basic%20Authentication%20is%20being%20turned%20off%20in%20Exchange%20Online).%20You%20should%20also%20know%20that%20it%20now%20allows%20restricting%20access%20to%20mailboxes%20access%20through%20mailbox%20access%20policies.%3C%2FP%3E%0A%3CUL%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fexchange%2Fclient-developer%2Fexchange-web-services%2Fhow-to-authenticate-an-ews-application-by-using-oauth%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EAuthenticate%20an%20EWS%20application%20by%20using%20OAuth%20%7C%20Microsoft%20Docs%3C%2FA%3E%3C%2FLI%3E%0A%3CLI%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fexchange-team-blog%2Fapplication-access-policy-support-in-ews%2Fba-p%2F2110361%22%20target%3D%22_blank%22%3EApplication%20Access%20Policy%20Support%20in%20EWS%20-%20Microsoft%20Tech%20Community%3C%2FA%3E%3C%2FLI%3E%0A%3C%2FUL%3E%0A%3CP%3E%3CSTRONG%3E%3CFONT%20size%3D%224%22%3E%3CEM%3EWhere%20can%20I%20get%20help%20on%20using%20Graph%3F%3CBR%20%2F%3E%3C%2FEM%3E%3C%2FFONT%3E%3C%2FSTRONG%3EOne%20of%20the%20best%20places%20to%20start%20is%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fgraph%2Fuse-the-api%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EUse%20the%20Microsoft%20Graph%20API%20-%20Microsoft%20Graph%20%7C%20Microsoft%20Docs%3C%2FA%3E%20and%20one%20of%20the%20best%20resources%20you%20can%20use%20to%20get%20practical%20is%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fen-us%2Fgraph%2Fgraph-explorer%2Fgraph-explorer-overview%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3EUse%20Graph%20Explorer%20to%20try%20Microsoft%20Graph%20APIs%20-%20Microsoft%20Graph%20%7C%20Microsoft%20Docs%3C%2FA%3E%3C%2FP%3E%0A%3CP%3E%3CFONT%20size%3D%226%22%3ESummary%3C%2FFONT%3E%3C%2FP%3E%0A%3CP%3EIn%20closing%2C%20we%20know%20some%20of%20our%20customers%20and%20partners%20have%20built%20solutions%20based%20on%20a%20preview%20feature%20we%20released%20some%20years%20ago%2C%20and%20we%20understand%20that%20updating%20code%20to%20remove%20this%20dependency%20might%20be%20time%20consuming.%20However%2C%20we%20need%20to%20invest%20our%20resources%20in%20building%20highly%20scalable%2C%20secure%20and%20robust%20solutions%20that%20both%20reflect%20Microsoft%E2%80%99s%20strategic%20imperatives%20and%20focus%20on%20the%20technologies%20we%20see%20our%20customers%20adopting.%20In%20this%20case%2C%20it%E2%80%99s%20Exchange%20Online.%3C%2FP%3E%0A%3CP%3E%3CSPAN%20class%3D%22author%22%3EExchange%20Online%20Team%3C%2FSPAN%3E%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-TEASER%20id%3D%22lingo-teaser-3221219%22%20slang%3D%22en-US%22%3E%3CP%3EWe%E2%80%99re%20announcing%20today%20that%20the%20%3CA%20href%3D%22https%3A%2F%2Fdocs.microsoft.com%2Fgraph%2Fhybrid-rest-support%22%20target%3D%22_self%22%20rel%3D%22noopener%20noreferrer%22%3Epreview%20program%20enabling%20REST%20API%20access%20to%20on-premises%20mailboxes%20for%20Hybrid%20Exchange%20organizations%3C%2FA%3E%20preview%20program%20is%20closing.%3C%2FP%3E%3C%2FLINGO-TEASER%3E%3CLINGO-LABS%20id%3D%22lingo-labs-3221219%22%20slang%3D%22en-US%22%3E%3CLINGO-LABEL%3EAnnouncements%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EDevelopment%3C%2FLINGO-LABEL%3E%3CLINGO-LABEL%3EHybrid%3C%2FLINGO-LABEL%3E%3C%2FLINGO-LABS%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3247830%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3247830%22%20slang%3D%22en-US%22%3E%3CP%3EHow%20does%20that%20impact%20Teams%20functionality%2C%20which%20uses%20REST%20against%20onPrem%20Exchange%20for%20Calendaring%20integration%20for%20example%3F%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3Ethanks%20guys%20for%20clarifying%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3Ergds%3C%2FP%3E%3CP%3EMartin%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3248460%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3248460%22%20slang%3D%22en-US%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F101115%22%20target%3D%22_blank%22%3E%40martin%3C%2FA%3E%20Likely%20to%20keep%20functioning%2C%20as%20it%20functioned%20before%20the%20introduction%20of%20this%20preview.%20It's%20just%20that%20when%20talking%20to%20EXO%20as%20a%20REST%20API%20endpoint%2C%20it%20won't%20proxy%20the%20request%20to%20the%20on-prem%20endpoint%20for%20on-prem%20mailboxes%20any%20longer.%20Teams%20uses%20AutodiscoverV2%20to%20determine%20the%20endpoint%20to%20talk%20to%20first%2C%20which%20will%20lead%20it%20directly%20to%20on-prem%20endpoint.%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3248611%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3248611%22%20slang%3D%22en-US%22%3E%3CP%3EI%20keep%20hoping%20MS%20will%20say%20more%20about%20the%20future%20of%20the%20Hybrid%20server%20model%20in%20general.%20We%20just%20moved%20our%20org%2C%20including%20all%20mailboxes%2C%20to%20M365%20in%20the%20cloud%20and%20yet%20(as%20a%20very%20small%20org)%20here%20we%20are%20supporting%20a%20standalone%20Exchange%20box%20for....reasons.%20Vendors%20keep%20telling%20me%20%22oh%20yeah%2C%20MS%20announced%20a%20roadmap%20for%20retiring%20Hybrid%20servers%20at%202018%20Ignite%22%20but%20it's%20just%20been%20crickets%20as%20far%20as%20I%20can%20tell.%26nbsp%3B%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EI%20get%20concerned%20seeing%20the%20retirement%20of%20these%20Hybrid%20features%20without%20appearing%20to%20have%20any%20holistic%20roadmap%20for%20the%20future%20of%20Hybrid%20server.%20Just%20my%20perception%2C%20at%20any%20rate.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3249544%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3249544%22%20slang%3D%22en-US%22%3E%3CP%3E%3CA%20href%3D%22https%3A%2F%2Ftechcommunity.microsoft.com%2Ft5%2Fuser%2Fviewprofilepage%2Fuser-id%2F1978%22%20target%3D%22_blank%22%3E%40Michel%20de%20Rooij%3C%2FA%3E%26nbsp%3BThanks%20Michel%2C%20this%20makes%20total%20sense%20now.%20Best%20regards%20Martin%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3256148%22%20slang%3D%22fr-FR%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3256148%22%20slang%3D%22fr-FR%22%3E%3CP%3EIf%20ews%20is%20going%20to%20continue%20is%20it%20possible%20to%20allow%20people%20to%20push%20and%20merge%20%3CA%20href%3D%22https%3A%2F%2Fgithub.com%2FOfficeDev%2Fews-managed-api%22%20target%3D%22_blank%22%20rel%3D%22noopener%20noreferrer%22%3Eon%20https%3A%2F%2Fgithub.com%2FOfficeDev%2Fews-managed-api%3C%2FA%3E%20%3F%20Or%20maybe%20put%20it%20in%20.net%20standard%3F%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3276252%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3276252%22%20slang%3D%22en-US%22%3E%3CBLOCKQUOTE%3E%3CHR%20%2F%3Ewe%E2%80%99ve%20seen%20low%20and%20now%20decreasing%20adoption%20rates%3CBR%20%2F%3E%3CHR%20%2F%3E%3C%2FBLOCKQUOTE%3E%3CP%3EI%20can't%20help%20but%20feel%20like%20this%20was%20mostly%20due%20to%20the%20fact%20that%20whenever%20there%20were%20problems%2C%20support%20and%20the%20product%20group%20would%20be%20reluctant%20to%20assist%20with%20fixing%20anything%20because%20it%20was%20a%20%22preview%20feature%22.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EFor%20example%2C%20using%20some%20API%20methods%20via%20the%20graph%20explorer%20worked%2C%20but%20using%20them%20outside%20of%20that%20didn't%2C%20due%20to%20them%20using%20slightly%20different%20backends%20as%20we%20discovered%20after%20a%206%20month%20support%20case.%20We%20also%20had%20cases%20where%20some%20methods%20would%20work%20in%20one%20hybrid%20tenant%20but%20not%20in%20another%2C%20which%20resulted%20in%20the%20product%20group%20issuing%20a%20%22will%20not%20fix%22%20due%20to%20it%20being%20a%20preview%20feature.%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EOf%20course%20there%20would%20be%20low%20adoption%20if%20the%20thing%20was%20intermittently%20broken%20and%20there%20was%20no%20viable%20support...%3C%2FP%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EFor%20those%20of%20us%20who%20are%20unable%20to%20move%20all%20mailboxes%20to%20the%20cloud%20for%20regulatory%20reasons%2C%20this%20is%20a%20massive%20blow%2C%20especially%20with%20more%20vendors%20developing%20only%20against%20the%20Graph%20API%20and%20not%20EWS.%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3283164%22%20slang%3D%22en-US%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3283164%22%20slang%3D%22en-US%22%3E%3CP%3E%26nbsp%3B%3C%2FP%3E%3CP%3EDo%20you%20plan%20to%20completely%20turn%20off%20EWS%20for%20Exchange%20Online%20in%20the%20next%20few%20years%3F%3C%2FP%3E%3CP%3ECan%20I%20assume%20EWS%20will%20always%20be%20available%20as%20a%20method%20for%20connecting%20to%20Exchange%20Online%20(with%20frozen%20functionality%20-%20but%20still)%3F%3C%2FP%3E%3C%2FLINGO-BODY%3E%3CLINGO-SUB%20id%3D%22lingo-sub-3320712%22%20slang%3D%22de-DE%22%3ERe%3A%20The%20End%20of%20the%20REST%20API%20for%20On-Premises%20Mailboxes%20Preview%3C%2FLINGO-SUB%3E%3CLINGO-BODY%20id%3D%22lingo-body-3320712%22%20slang%3D%22de-DE%22%3E%3CP%3EWe%20released%20some%20weeks%20ago%20an%20App%20which%20is%20based%20on%20the%20REST%20API%20for%20On-Premises%20Mailboxes.%20EWS%20is%20no%20alternative%20for%20us.%20Therefore%20we%20are%20very%20unhappy%20with%20your%20decision.%20Please%20revert!%3C%2FP%3E%3C%2FLINGO-BODY%3E
Co-Authors
Version history
Last update:
‎Mar 04 2022 08:01 AM
Updated by: