Edit

How to use Power Automate Connector to set up a Flow for events

  • Article

Applies to:

Want to experience Microsoft Defender for Endpoint? Sign up for a free trial.

Automating security procedures is a standard requirement for every modern Security Operations Center (SOC). For SOC teams to operate in the most efficient way, automation is a must. Use Microsoft Power Automate to help you create automated workflows and build an end-to-end procedure automation within a few minutes. Microsoft Power Automate supports different connectors that were built exactly for that.

Use this article to guide you in creating automations that are triggered by an event, such as when a new alert is created in your tenant. Microsoft Defender API has an official Power Automate Connector with many capabilities.

The Actions page in the Microsoft Defender 365 portal

Note

For more information about premium connectors licensing prerequisites, see Licensing for premium connectors.

Usage example

The following example demonstrates how to create a Flow that is triggered anytime a new Alert occurs on your tenant. You'll be guided on defining what event starts the flow and what next action will be taken when that trigger occurs.

  1. Log in to Microsoft Power Automate.

  2. Go to My flows > New > Automated-from blank.

    The New flow pane under My flows menu item in the Microsoft Defender 365 portal

  3. Choose a name for your Flow, search for "Microsoft Defender ATP Triggers" as the trigger, and then select the new Alerts trigger.

    The Choose your flow's trigger section in the Microsoft Defender 365 portal

Now you have a Flow that is triggered every time a new Alert occurs.

A trigger description

All you need to do now is choose your next steps. For example, you can isolate the device if the Severity of the Alert is High and send an email about it. The Alert trigger provides only the Alert ID and the Machine ID. You can use the connector to expand these entities.

Get the Alert entity using the connector

  1. Choose Microsoft Defender ATP for the new step.

  2. Choose Alerts - Get single alert API.

  3. Set the Alert ID from the last step as Input.

    The Alerts pane

Isolate the device if the Alert's severity is High

  1. Add Condition as a new step.

  2. Check if the Alert severity is equal to High.

    If yes, add the Microsoft Defender ATP - Isolate machine action with the Machine ID and a comment.

    The Actions pane

  3. Add a new step for emailing about the Alert and the Isolation. There are multiple email connectors that are easy to use, such as Outlook or Gmail.

  4. Save your flow.

You can also create a scheduled flow that runs Advanced Hunting queries and much more!

Tip

Do you want to learn more? Engage with the Microsoft Security community in our Tech Community: Microsoft Defender for Endpoint Tech Community.