Outlook REST API v2.0 production and beta endpoint deprecation

Office Add-ins team

Update January 27, 2023: Based on customer signals and feedback from multiple partners working through this change, we are pushing the deprecation deadline to a further date not yet defined. Please note that our team is actively working to define a new date which will be announced on this same blog/media. We advise our users to continue with their migration efforts since the target for the new deprecation date will still be in 2023. We will provide a 6 months’ notice period before enforcing the block on the endpoint. 

Microsoft Graph is the modern API for the Microsoft 365 platform.  We make continuous, significant investments in its security, performance, and features to ensure it meets the needs of our own product teams as well as the global ecosystem of developers who build applications using its capabilities. 

While we’re investing in Microsoft Graph, we’re also examining our legacy surface areas. Some of our existing legacy services become obsolete based on the new functionality and they no longer provide the best way to access M365 data. When this happens, we start the two-year process defined in our service deprecation policy to shut down the service in question.  

Today we are announcing the deprecation of both the production and beta Outlook REST API v2.0 endpoints, and that they will be decommissioned on November 30, 2022. Once past this date, the service will be retired, and developers may no longer access it. As part of the deprecation, we will soon disable creation of new Outlook REST API v2.0 applications. 

Going forward, we will not be making any further investments in the capabilities or capacity of the Outlook REST API v2.0. This will result in two changes for developers.  First, we will retire the OAuth Sandbox by December 31, 2020. Additionally, we have removed the “Exchange” app permission from the Azure portal.  We will post an article in the coming days with additional information on a workaround for creating apps accessing EWS. 

If you are using the Outlook REST API v2.0 in your appyou should plan on transitioning to Microsoft Graph 

Please refer to: https://docs.microsoft.com/en-us/outlook/rest/compare-graph#moving-from-outlook-endpoint-to-microsoft-graph as a starting point.  

We understand that for some applications this change, even if anticipated, will require some amount of work to accommodatebut we are confident it will ensure better security, reliability, and performance for our customers. The Microsoft Support Community is here to support you through this transition.  

Thanks for continuing with us on our journey as we continue to improve productivity for everyone on the planet, and please let us know if you have any additional questions or concerns by reaching out to our Q&A Mail forum.   

Feedback usabilla icon