Use the Microsoft Graph API to get change notifications
APIs under the
/beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported.
The Microsoft Graph REST API uses a webhook mechanism to deliver notifications to clients. A client is a web service that configures its own URL to receive notifications. Client apps use notifications to update their state upon changes. For more details, including how to subscribe to and handle incoming notifications, see Set up notifications for changes in user data.
Using the Microsoft Graph API, an app can subscribe to changes on the following resources:
- Group conversations
- Content shared on OneDrive, including drives associated with SharePoint sites
- Users' personal OneDrive folders
- Security alerts
In general, subscription operations require read permission to the resource. For example, to get notifications for messages, your app needs the
Mail.Read permission. The create subscription article lists permissions needed for each resource type. The following table lists the types of permissions your app can request to use webhooks for specific resource types.
|Permission type||Supported resource types|
|Delegated - work or school account||contact, conversation, drive, event, group, message, user, alert|
|Delegated - personal Microsoft account||contact, drive, event, message|
|Application||contact, conversation, drive, event, group, message, user, alert|
We'd love to hear your thoughts. Choose the type you'd like to provide:
Our feedback system is built on GitHub Issues. Read more on our blog.