Skip to main content
Microsoft Graph

Learn to integrate Microsoft Graph in Torq and utilize the steps in secure automated workflows.

Updated this week

Microsoft Graph is the mechanism by which you access APIs for the majority of Microsoft services, which you'll use as steps in your workflows.

To use Microsoft steps in your workflows, register a new app in Entra ID (formerly Azure AD), add Microsoft Graph permissions to the app, and grant admin consent. After you register the app, you'll create your integrations in Torq.

Configure Microsoft Graph in the Azure Portal

Register a New App

  1. Log in to your Azure Portal.

  2. Select App registrations > New registration.

  3. Enter a meaningful name for the app.

  4. Select the required supported account types. For more information, click Help Me Choose.

  5. You don't have to use the Redirect URI option.

  6. Click Register.

Add API Permissions

  1. Select API permissions > Add a permission > Microsoft Graph.

  2. Click Application Permissions and select the permissions required for the Microsoft services you want to use in your Torq workflows.

  3. Click Add Permissions.

    1. It is recommended that you add at least the following permissions:

      Mail.Read
      Mail.ReadBasic
      Mail.ReadBasic.All
      Mail.ReadWrite
      Mail.Send
      MailboxSettings.Read
      MailboxSettings.ReadWrite
      User.Read

  4. Click Grant admin consent for {organization name}.

Create a Client Secret

Copy the client secret value and store it in a safe place. You might not be able to access it again. You need the client secret when configuring a Microsoft 365 integration in Torq.

  1. From the left panel, click Certificates & secrets.

  2. Click New client secret.

  3. Configure the client's secret.

  4. Enter a meaningful description.

  5. Set the expiration date for the client secret. It is recommended that you use a custom date in the extended future (but in compliance with your organization's policies).

  6. Click Add.

Copy the App IDs

To create a Microsoft 365 integration in Torq, you'll need several IDs and the client secret. Click Overview to view the Application (client) ID and Directory (tenant) ID.

Create a Microsoft 365 Integration in Torq

Microsoft 365 Defender and Microsoft Defender for Endpoint have a dedicated step Create session that generates the access token required by their integration steps.

Perform these steps in Torq.

  1. Go to Build > Integrations > Steps > Microsoft 365, and click Add.

  2. Enter a meaningful name for the integration.

  3. Enter the Tenant ID, Client ID, and Secret Value.

  4. Click Add.

Did this answer your question?