Skip to main content Link Menu Expand (external link) Document Search Copy Copied
Azure-411

How-To

Subscribing to Graph Change Notifications with Logic Apps

In this how-to, I will cover the fundamental concepts and logic that needs to be implimented in order to leverage a Logic App as a Webhook with Graph Change notifications. If you want a hands-on lab that walks you through the process please click here to navigate to the hands-on labs

Process the Validation Token that is sent when the Graph Subscription is created

3 Requirements must be met in order for the subscription to be created

  1. An HTTP 200 Status Code must be returned
  2. The Content-Type must be of ‘text/plain’
  3. Return a boday containing the Validation Token that was provided by the initial Graph request
  4. All this must be done within 10 seconds of the initial Graph request

Upon making the initial request to Graph to create the Subscription, Graph will call the notificationUrl, sending over the Validation Token. Once the Validation Token is received, we need to send an HTTP response that meets the requirements above.

Click here to read the documentation on how to handle the Validation Token.

Process the change notification

Once the Logic App has successfully processed the Validate Token, Graph will start to send change notification details to the notificaitonUrl when a change occurs.

  1. When Graph sends the Logic App a change notification it will send in the request body a JSON collection with the change notificaiton details. Graph will continue to retry up to 4 Hours. If Graph does not receive a 200 status code within the period, it will discard the change notification.

You can review the Change Notificaiton Example section in the above link to better understand the format of the JSON and how Graph is expecting the Logic App to respond.

Closing Summary

The Logic App must respond to the Validation Token in order for you to be able to create the Graph Subscription and it must properly respond to the change notification. At this point if the Logic App is properly handling the Validation Token and the change notificaitons you are ready to add business logic.

If you need help setting up the Graph subscription, click here for steps on how to create a Graph Subscription.