Microsoft Graph

About Microsoft Graph

Microsoft Graph is a REST API that provides a single endpoint for accessing data and relationships across Microsoft 365 services, including Entra ID (formerly Azure AD), OneDrive, Exchange Online, and Planner. The v1.0 endpoint (https://graph.microsoft.com/v1.0) represents API sets that have reached general availability, with updates that are additive and do not break existing app scenarios. A beta endpoint is also available for APIs still in preview, though Microsoft advises against production dependencies on it since those APIs are subject to change.

The API supports user-centric operations such as retrieving a user's profile and photo, accessing organizational hierarchy information (manager and direct reports), reading and modifying files on OneDrive, managing calendar events on Exchange Online, setting automatic out-of-office replies, and finding tasks assigned to a user in Planner. It also supports Microsoft 365 group scenarios, including reporting on group communication activity, viewing group plans and task assignments, starting group conversations, and managing group notebooks.

The product is intended for developers building applications that integrate with Microsoft 365 data and services. Requests follow the pattern https://graph.microsoft.com/v1.0/{resource}?[query_parameters], and Microsoft provides SDKs and a tool called Graph Explorer to support development against the API.

Key features

• Single REST endpoint to access user profiles, files, calendars, and mail across Microsoft 365
• Access a user's OneDrive files and identify the last person who modified a file
• Query a user's Exchange Online calendar to find the best meeting time with their team
• Subscribe to and track changes in a user's calendar
• Retrieve tasks assigned to a user in Planner
• Run reports on Microsoft 365 groups, including communication activity among members

Frequently asked questions