---
title: Torq
description: No-code automation for security and operations teams
breadcrumbs: Docs > Integrations > Torq
---

# Torq
Supported OS Integration version1.0.0
## Overview{% #overview %}

The [Torq](https://torq.io) integration enables you to trigger workflows in response to Datadog alerts, providing alert enrichment. You can then send back events directly from your Torq workflows to your Datadog event stream and dedicated Torq dashboard.

## Setup{% #setup %}

To set up this integration, you must have an active [Torq account](https://torq.io/get-started/) and an Account Owner role in that account. You must also have proper admin permissions in Datadog.

### Create a Datadog trigger integration in Torq{% #create-a-datadog-trigger-integration-in-torq %}

1. Go to **Integrations** > **Triggers**, locate the **Datadog** card, and click **Add**.

1. Enter a meaningful name for the integration and click **Add**.

1. Copy the generated Webhook URL. You need this URL to configure a Webhook integration in your Datadog tenant.

### Define Datadog monitors to trigger events in Torq{% #define-datadog-monitors-to-trigger-events-in-torq %}

1. Navigate to **Integrations** > **Integrations**, click the **Webhooks** card, and click **New**. 

1. Enter a meaningful name for the Webhook integration and paste the generated Webhook URL from Torq. You need the integration name to associate the identifier (used for specific Datadog monitors to trigger Torq) and generated Webhook URL from Torq. 

1. Torq recommends adding additional alert information to the payload. You can use portions of the following configuration:

   ```json
   {
       "body": "$EVENT_MSG",
       "title": "$EVENT_TITLE",
       "date": "$DATE",
       "id": "$ID",
       "metadata": {
           "AGGREG_KEY": "$AGGREG_KEY",
           "ALERT_CYCLE_KEY": "$ALERT_CYCLE_KEY",
           "ALERT_ID": "$ALERT_ID",
           "ALERT_METRIC": "$ALERT_METRIC",
           "ALERT_QUERY": "$ALERT_QUERY",
           "ALERT_SCOPE": "$ALERT_SCOPE",
           "ALERT_STATUS": "$ALERT_STATUS",
           "ALERT_TITLE": "$ALERT_TITLE",
           "ALERT_TRANSITION": "$ALERT_TRANSITION",
           "ALERT_TYPE": "$ALERT_TYPE",
           "EMAIL": "$EMAIL",
           "EVENT_MSG": "$EVENT_MSG",
           "EVENT_TITLE": "$EVENT_TITLE",
           "EVENT_TYPE": "$EVENT_TYPE",
           "HOSTNAME": "$HOSTNAME",
           "ID": "$ID",
           "LAST_UPDATED": "$LAST_UPDATED",
           "LINK": "$LINK",
           "METRIC_NAMESPACE": "$METRIC_NAMESPACE",
           "ORG_ID": "$ORG_ID",
           "ORG_NAME": "$ORG_NAME",
           "PRIORITY": "$PRIORITY",
           "SNAPSHOT": "$SNAPSHOT",
           "TAGS": "$TAGS",
           "TEXT_ONLY_MSG": "$TEXT_ONLY_MSG",
           "USER": "$USER",
           "USERNAME": "$USERNAME",
           "LOGS_SAMPLE": "$LOGS_SAMPLE"
       }
   }
   ```

1. Pick monitors to trigger Torq Playbooks and add a reference to the newly created Webhook integration in the **Alert Your Team** field. For more details, see [Manage Monitors](https://docs.datadoghq.com/monitors/manage_monitor/).

## Use Datadog steps in Torq workflows{% #use-datadog-steps-in-torq-workflows %}

You need to create a Datadog API key and an application key to use as input parameters for Datadog steps in Torq.

**Note:** Some Datadog steps in Torq require an API key and application key, while other steps require the Datadog integration.

### Create an API key in Datadog{% #create-an-api-key-in-datadog %}

After you create the API key, copy and save it because you are not able to access it later. For more information, see [API and Application Keys](https://docs.datadoghq.com/account_management/api-app-keys/#add-an-api-key-or-client-token).

1. Hover over your user name and select **Organization Settings**.
1. From the left panel, click **API Keys**.
1. Click **+ New Key**.
1. Enter a meaningful name for the API key such as `Torq` and click **Create Key**.
1. Copy the `Key` and save it. You need this key to create a Datadog integration in Torq.

### Create an application key in Datadog{% #create-an-application-key-in-datadog %}

After you create the application key, copy and save it because you are not able to access it later. For more information, see [API and Application Keys]][13](https://docs.datadoghq.com/account_management/api-app-keys/#add-application-keys).

1. Hover over your user name and select **Organization Settings**.
1. From the left panel, click **Application Keys**.
1. Click **+ New Key**.
1. Enter a meaningful name for the application key such as `Torq` and click **Create Key**.
1. Copy the `Key` and save it. You need this key to create a Datadog integration in Torq.

### Create a Datadog integration in Torq{% #create-a-datadog-integration-in-torq %}

This integration enables you to use Datadog steps in your Torq workflows.

1. Go to **Integrations** > **Steps**, locate the **Datadog** card, and click **Add**.

1. Enter a meaningful name for the integration such as `Datadog-<monitor_type>` and click **Add**.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

The Torq integration does not provide any metrics.

### Events{% #events %}

The Torq integration allows you to send events to your Datadog event stream from a Torq workflow using the Datadog Post Event step. You can use the step with your playbooks to notify Datadog about successful mitigations and execution failures. You can also send enriched alert data back to Datadog.

### Service Checks{% #service-checks %}

The Torq integration does not include any service checks.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).