Migrate your apps from Azure AD Graph to Microsoft Graph

Important

Azure Active Directory (Azure AD) Graph is deprecated but won't be retired on June 30, 2022 as previously announced. Listening closely to your feedback about the challenges of migrating such a critical dependency, we're delaying the retirement date through at least the end of this year, 2022. We’ll provide a retirement update mid-calendar year including releasing more tools to help you to migrate your apps. However, the Azure AD Graph licensing assignment APIs will be retired on March 31, 2023 as recently announced.

Why use Microsoft Graph?

Microsoft Graph represents our best-in-breed API surface. It offers a single unified endpoint to access Azure AD services and Microsoft 365 services such as Microsoft Teams and Microsoft Intune. Microsoft Graph API's usage has more than doubled that of Azure AD Graph, and in the past two years we have added 167 new features. All new functionalities will only be available through the Microsoft Graph.

Microsoft Graph is also more secure and resilient than Azure AD Graph.

Microsoft Graph has all the capabilities that have been available in Azure AD Graph and new APIs like identity protection and authentication methods. Its client libraries offer built-in support for features like retry handling, secure redirects, transparent authentication, and payload compression.

Switch to Microsoft Graph to take advantage of these enhanced capabilities and:

The rest of the articles in this section help you migrate your app from Azure AD Graph to Microsoft Graph. You'll find:

  • A checklist to help you plan the migration.
  • Guidance describing specific differences between the APIs.
  • Links to more resources and examples to illustrate specific differences.
  • An FAQ to address other questions or concerns.

Send any other questions, open issues, and feature requests through Microsoft Q&A by using the tag azure-ad-graph-deprecation.

Next steps