Use the Microsoft Graph API to get change notifications

• 2/21/2019
• 2 minutes to read
• Contributors
  • 
  • 
  • 
  • 
  • 
  • all

The Microsoft Graph REST API uses a webhook mechanism to deliver change 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:

• Outlook message
• Outlook event
• Outlook personal contact
• user
• group
• Office 365 group conversation
• Content within the hierarchy of any folder driveItem on a user's personal OneDrive
• Content within the hierarchy of the root folder driveItem on OneDrive for Business
• Security alert

Permissions

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.

See also

• Subscription resource type
• List subscriptions
• Get subscription
• Create subscription
• Update subscription
• Delete subscription