Migrate your apps from Azure AD Graph to Microsoft Graph

Important

Azure Active Directory (Azure AD) Graph is deprecated and will be retired at any time after June 30, 2023, without advance notice, as we announced in September, 2022. Though we reserve the right to turn it off after June 30, 2023, we want to ensure all customers migrate off and discourage applications from taking production dependencies on Azure AD Graph. Investments in new features and functionalities will only be made in Microsoft Graph and we'll only make security-related fixes to Azure AD Graph.

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:

• Microsoft 365 group management.
• External user invitations.
• The ability to restore users, Microsoft 365 groups, applications, and service principals after they've been deleted.
• Webhook notifications on users and groups.
• Advanced license management features including group-based licensing.
• Identity governance features such as:
  • Privileged identity management (PIM) to elevate users to privileged roles only when needed and for a limited time period.
  • Access reviews for one-time or recurring access reviews for attestation of user's access rights.
  • Terms-of-use to enable organizations to present information for legal or compliance requirements, like disclaimer notices.
• Security features such as:
  • Identity risk events.
  • Risky users.
• Client libraries and samples available on many more platforms and languages. Microsoft Graph SDKs provide a discoverable interface to easily access your data while transparently handling token acquisition, retry handling due to errors and throttling, secure redirect handling and model serialization and deserialization.
• More OData query capabilities supported by resources such as users, groups, applications, and service principals.

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

• Walk through the app migration checklist to help you plan the migration.
• Explore Microsoft Graph concepts and practices.
• Use Graph Explorer to experiment with Microsoft Graph.
• Learn more about progress updates and timelines in Microsoft Graph or the Azure AD Graph.
• Get answers to questions you might have about the migration.