Overview of Microsoft Graph

Microsoft Graph is the gateway to data and intelligence in Microsoft 365. Microsoft Graph provides a unified programmability model that you can use to take advantage of the tremendous amount of data in Office 365, Enterprise Mobility + Security, and Windows 10.

You can use the Microsoft Graph API to build apps for organizations and consumers that interact with the data of millions of users. With Microsoft Graph, you can connect to a wealth of resources, relationships, and intelligence, all through a single endpoint: https://graph.microsoft.com.

What's in the graph?

Microsoft Graph exposes REST APIs and client libraries to access data on the following:

  • Azure Active Directory
  • Office 365 services: SharePoint, OneDrive, Outlook/Exchange, Microsoft Teams, OneNote, Planner, and Excel
  • Enterprise Mobility and Security services: Identity Manager, Intune, Advanced Threat Analytics, and Advanced Threat Protection.
  • Windows 10 services: activities and devices
  • Education

To find out more, see Major services and features in Microsoft Graph.

Microsoft Graph connects all the resources across these services using relationships. For example, a user can be connected to a group through a memberOf relationship, and to another user through a manager relationship. Your app can traverse these relationships to access these connected resources and perform actions on them through the API.

You can also get valuable insights and intelligence about the data from Microsoft Graph. For example, you can get the popular files trending around a particular user, or get the most relevant people around a user.

Discover the possibilities in the relationships within Microsoft Graph.

An image showing the primary resources and relationships that are part of the graph

What can you do with Microsoft Graph?

You can use Microsoft Graph to build experiences around the user's unique context to help them be more productive. Imagine an app that...

  • Looks at your next meeting and helps you prepare for it by providing profile information for attendees, including their job titles and who they work with, as well as information about the latest documents and projects they're working on.
  • Scans your calendar, and suggests the best times for the next team meeting.
  • Fetches the latest sales projection chart from an Excel file in your OneDrive and lets you update the forecast in real time, all from your phone.
  • Subscribes to changes in your calendar, sends you an alert when you’re spending too much time in meetings, and provides recommendations for the ones you can miss or delegate based on how relevant the attendees are to you.
  • Helps you sort out personal and work information on your phone; for example, by categorizing pictures that should go to your personal OneDrive and business receipts that should go to your OneDrive for Business.

You can do all this and more with the Microsoft Graph API.

Note: When you use the Microsoft Graph API, you agree to the Microsoft Graph Terms of Use and the Microsoft Privacy Statement.

Check out some of these common scenarios for working with the Microsoft Graph API. The links take you to the Graph Explorer.

Operation URL
GET my profile https://graph.microsoft.com/v1.0/me
GET my files https://graph.microsoft.com/v1.0/me/drive/root/children
GET my photo https://graph.microsoft.com/v1.0/me/photo/$value
GET my mail https://graph.microsoft.com/v1.0/me/messages
GET my high importance email https://graph.microsoft.com/v1.0/me/messages?$filter=importance%20eq%20'high'
GET my calendar events https://graph.microsoft.com/v1.0/me/events
GET my manager https://graph.microsoft.com/v1.0/me/manager
GET last user to modify file foo.txt https://graph.microsoft.com/v1.0/me/drive/root/children/foo.txt/lastModifiedByUser
GET Office365 groups I’m member of https://graph.microsoft.com/v1.0/me/memberOf/$/microsoft.graph.group?$filter=groupTypes/any(a:a%20eq%20'unified')
GET users in my organization https://graph.microsoft.com/v1.0/users
GET groups in my organization https://graph.microsoft.com/v1.0/groups
GET people related to me https://graph.microsoft.com/v1.0/me/people
GET items trending around me https://graph.microsoft.com/beta/me/insights/trending
GET my notes https://graph.microsoft.com/v1.0/me/onenote/notebooks

Access Microsoft Graph at scale

Microsoft Graph Data Connect enables bulk - rather than the traditional transactional - access to Office 365 data. With the bulk Office 365 data, you can use Azure tools to build intelligent apps that:

  • Find you the closest expert on a topic to you in your organization
  • Automate knowledge base creation
  • Analyze meeting requests to provide insights into conference room utilization
  • Detect fraud with productivity and communication data

When should I use Microsoft Graph Data Connect?

Microsoft Graph Data Connect provides a new way for you to interact with the data that's available through Microsoft Graph APIs. In addition to providing scalable access to Office 365 data, Microsoft Graph Data Connect also provides a unique set of capabilities that streamline the building of intelligent applications, all within the Microsoft cloud.

Feature Microsoft Graph API Microsoft Graph Data Connect
Access scope Single user or entire tenant Many users or groups
Access pattern Real time Recurrent schedule
Data operations Operates on data master Operates on a cache of the data
Data protection Data is protected while in Microsoft 365 Data protection is extended to the cache of data in your Azure subscription
User consent Self
Resource types
Admin consent Entire organization
Resource types
Select groups of users
Resource types and properties
Excludes users
Access tools RESTful web queries Azure Data Factory

For more information about Microsoft Graph Data Connect, see Microsoft Graph Data Connect. To get started, see Overview of Microsoft Graph Data Connect.

Next steps