Microsoft Defender XDR
General

Configure integration profiles for generated playbooks - Microsoft Defender XDR | Microsoft Learn

In brief

Adds instructions for creating integration profiles used by generated playbooks, including prerequisites, supported authentication methods, and Microsoft Graph setup.

What Defender admins need to know

Administrators can use the documented steps and permission requirements to configure connections for generated playbooks.

Summaries are generated from the documentation change itself.

Documentation change

The comparison below shows only the changed extract. Use the full-page view for complete context.

new file mode 100644

layout: Conceptual title: Configure integration profiles for generated playbooks - Microsoft Defender XDR | Microsoft Learn canonicalUrl: https://learn.microsoft.com/en-us/defender-xdr/siem-defender-configure-integration-profiles breadcrumb_path: /defender-xdr/breadcrumb/toc.json permissioned-type: public feedback_system: Standard feedback_product_url: https://techcommunity.microsoft.com/t5/microsoft-365-defender/bd-p/MicrosoftThreatProtection uhfHeaderId: MSDocsHeader-MicrosoftDefender manager: orspodek description: Learn how to configure integration profiles for generated playbooks in the Microsoft Defender portal. ms.service: microsoft-defender ms.subservice: unified-security-operations author: guywi-ms ms.author: guywild ms.date: 2026-07-15T00:00:00.0000000Z ms.collection:


Configure integration profiles for generated playbooks - Microsoft Defender XDR | Microsoft Learn

Integration profiles define the API connection details used by generated playbooks. Configure integration profiles before you create or run generated playbooks that call Microsoft or third-party services.

Each integration profile includes connection details such as the base API URL, authentication method, and required credentials.

Prerequisites

Before you begin, make sure that:

  • You have access to the Microsoft Defender portal.
  • You have the Automation Integration Unified RBAC permission with Read and Write access.
  • You have the credentials required for the target API.
  • To run automation on third-party data ingested through Log Analytics, you have a Microsoft Sentinel workspace.

Create an integration profile

  1. Sign in to the Microsoft Defender portal.

  2. Go to Microsoft Sentinel > Configuration > Automation.

  3. Select the Integration Profiles tab.

  4. Select Create.

  5. Enter an integration name.

  6. Enter a description.

  7. Enter the base API URL for the service.

  8. Select the authentication method.

    Supported authentication methods include:

    • OAuth2 Client Credentials
    • API Key
    • AWS Auth
    • User and Password
    • Bearer/JWT Authentication
    • Hawk
  9. Enter the required authentication details.

  10. Review the integration profile settings.

  11. Select Create.

Create a Microsoft Graph integration profile

Use a Microsoft Graph integration profile when a generated playbook needs to call Microsoft Graph APIs.

  1. In the Azure portal, go to Microsoft Entra ID > App registrations.

  2. Select New registration.

  3. Enter a name for the application.

  4. Complete the app registration.

  5. Copy the Application (client) ID and Directory (tenant) ID.

  6. Go to Certificates & secrets.

  7. Select New client secret.

  8. Copy the client secret value and store it securely.

    Important

    You can't retrieve the client secret value after leaving the page.

  9. Sign in to the Microsoft Defender portal.

  10. Go to Microsoft Sentinel > Configuration > Automation.

  11. Select the Integration Profiles tab.

  12. Select Create.

  13. Configure the profile with the following values:

    FieldValue
    Integration nameEnter a descriptive name, such as Graph Integration.
    DescriptionEnter a short description.
    Base API URLhttps://graph.microsoft.com
    Authentication methodOAuth2
    Client IDEnter the Application client ID.
    Client secretEnter the client secret value.
    Token endpointhttps://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/token
    Scopeshttps://graph.microsoft.com/.default
  14. Replace {TENANT_ID} with the Directory tenant ID.

  15. Select Create.

Edit an integration profile

You can edit the integration name and description after the profile is created.

  1. Sign in to the Microsoft Defender portal.
  2. Go to Microsoft Sentinel > Configuration > Automation.
  3. Select the Integration Profiles tab.
  4. Select the integration profile.
  5. Update the name or description.
  6. Save your changes.

Note

The API URL and authentication method can't be changed after an integration profile is created. To change the API URL or authentication method, create a new integration profile.

Limitations

Integration profiles have the following limitations:

  • Microsoft Graph and Azure Resource Manager integrations aren't enabled by default and must be manually created.
  • The API URL and authentication method can't be changed after an integration profile is created.
  • The maximum number of integrations per tenant is 500. \ No newline at end of file