Configure the webhook in Azure Service Health

Configure the webhook endpoint so that Azure Service Health can use the endpoint to communicate with Incident Response.

Before you begin

  • Ensure you have created an account in Azure Service Health.
  • Ensure that you have created a resource and the resource is a part of a resource group.

Role required: Responder, Manager, or Administrator

About this task

Note: While this integration with a third-party product is supported, the documentation here is based upon information provided by that third-party. More current information about the operation of that third-party’s system may be available from them directly.


  1. Log in to the Microsoft Azure portal.
  2. Under Azure Services, click Service Health.
  3. From the navigation pane, click Alerts > Health alerts.
    Service Health health alerts page.
  4. Click + Add service health alert.
    The Create an alert rule page appears.
    Page to create an alert rule.
  5. In the Create an alert rule page, perform the following actions:
    1. Select the Subscription, Services, and Regions for which you want to be alerted.
    2. Choose the Event types you want to be alerted for. Available types are: Service issue, Planned maintenance, Health advisories, and Security advisory.
  6. Click Select action group to choose an existing action group or to create a new action group.
    An action group invokes a defined set of notifications and actions when an alert is triggered.
    Page to select an action group.
  7. Optional: If you don't already have an action group in your subscription to select, create an alert action group and associate it with the alert rule. To create a new action group, click + Create action group.
    The Create an action group page appears.
    Page to create an action group.
    On the Create an action group page, perform the following actions:
    1. In the Subscription field, select the subscription to manage deployed resources and costs.
    2. In the Resource group field, select a resource group that will organize and manage all your resources.
    3. In the Action group name field, enter a name for the action group.
    4. Click the Actions tab and select the Action type as Webhook.
      Page to select the action type.
    5. In the Name field, enter the name for the action type.
    6. Under the Webhook section, in the URL field, enter the webhook URL copied from Incident Responsein Create a webhook endpoint for Azure Service Health.
    7. Set Enable the common alert schema option to Yes and click OK.
      Note: If you set this option to No, alerts won't be generated in Incident Response.
    8. Click Review + create.
    9. To test how the action group works, click Test action group (preview).
    10. In the Select sample type field, select Service health alert.
    11. Click Test.
    When you are done creating the alert group, continue with the alert rule creation.
    Details of action rule.
  8. Define your alert details by entering an Alert rule name and Description.
  9. Select the Resource group where you want the alert to be saved.

    The alert becomes active and begins to trigger based on the conditions you specified during creation.

  10. Select the Enable alert rule upon creation check box.
  11. Click Create alert rule.


Azure Service Health events, based on the alert rule, are forwarded to Incident Response through the configured webhook endpoint.