Skip to main content

Trigger an alert webhook endpoint on assignee change

To send a notification whenever the assignee for an alert changes:

  1. Navigate to Integrations > Outbound Integrations, and click Webhook Endpoint.

  2. Click the Alert Webhook Endpoint tab, and then click Add Alert Webhook Endpoint.

  3. Add a name (required) and a description (optional) for the webhook endpoint in the spaces provided.

  4. Configure the new alert webhook endpoint to send alerts to the target system.

    NOTE: Do not add a trigger to the alert webhook endpoint. Webhook endpoints are designed to be triggered by workflows. While you can also add a trigger to the webhook endpoint, it is not necessary unless you want to perform more complex processing.

  5. After saving your alert webhook endpoint, navigate to Correlate & Automate > Workflow Engine.

  6. Click the Alert Workflows tab, then click Add Workflow.

    NOTE: Alert webhook endpoints are triggered from alert workflows. To use an alert webhook endpoint, you must also create an alert workflow to trigger it.

  7. Add a name (required) and a description (optional) for the workflow in the spaces provided.

  8. Configure the Trigger:

    1. For this example, select Changed alerts only for the type. This example only addresses alerts where the assignee has changed.

    2. Under Change Origin, select Changes from anywhere for the purposes of this example. An assignee could change due to deduplication, but it could also result from a manual or workflow action change.

    3. Add the the following filter:

      changes in ( assignee )

      This filter allows the trigger to match alerts where the changes field includes the value "assignee."

      Whenever a change to an alert occurs, the type of change is recorded in the changes field. While the field may include multiple values, it always includes the most recent change (multiple changes can happen at the same time). Refer to the table in Understand alerts and alert details for a complete list of possible values for the alert changes field.

  9. Click Add Action, select Send to Endpoint in the list of actions, and then click Add Selected Action.

  10. Click in the Webhook section and select the webhook endpoint you created earlier from the list.

  11. Complete the other sections of the workflow action as needed. Refer to Send to Endpoint action for assistance.

  12. Save the workflow.

  13. Enable the workflow.

The workflow will now send alert notifications to the target system defined by your webhook whenever the assignee for an alert changes.

In this section: