---
title: Linear
description: Integrate Linear with Datadog
breadcrumbs: Docs > Integrations > Linear
---

# Linear
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: app.ddog-gov.com

{% alert level="danger" %}
This product is not supported for your selected [Datadog site](https://docs.datadoghq.com/getting_started/site.md). ().
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Linear is an issue tracking and project management tool. It helps teams plan, track, and ship work. The Datadog integration for Linear enables you to create issues from monitors.

## Setup{% #setup %}

### Installation{% #installation %}

1. Navigate to the [Datadog Linear integration tile](https://app.datadoghq.com/integrations/linear) and click **Add Account**.
1. On the Linear authorization page, click **Authorize**.

### Configuration{% #configuration %}

To create Linear issues from Datadog monitor alerts, see Configure an issue template.

To configure automated Linear issue creation with bidirectional syncing in Case Management, see the instructions for Configuring a Linear webhook and the [Case Management](https://docs.datadoghq.com/service_management/case_management/settings.md) documentation.

## Configure an Issue Template{% #configure-an-issue-template %}

Issue templates define how issues are created in Linear from Datadog alert events.

To create an issue template:

1. In Datadog, click **New Issue Template** in the **Create Linear issues from Datadog** section.
1. Enter a name for your issue template. This name, prefixed with `linear-`, becomes the handle you can use in your monitor to send notifications to (for example, `linear-my-issue-template-name`).
1. Select a Linear account.
1. Select the team.

## Configure a Linear webhook{% #configure-a-linear-webhook %}

Enable cases created in Case Management to automatically create issues in Linear and keep both resources synced through Linear webhooks.

To create a Linear webhook:

1. In your Linear workspace, navigate to **Settings**.
1. In the left-hand menu, select **API**.
1. Under the *Webhooks* section, click the **+** icon.
1. Enter `Datadog Webhook` as the webhook name.
1. Navigate to the [Datadog Linear integration tile](https://app.datadoghq.com/integrations/linear).
1. Under the **Accounts** tab, click on the Linear account you want to set up the webhook for and copy the webhook URL.
1. Navigate back to Linear and paste the webhook URL under *URL*.
1. Enable the following data change events.
1. Leave everything else unchecked.
1. Copy the *Signing Secret* to clipboard.
1. Click the **Create Webhook** button at the bottom of the page.
1. Go back to Datadog, paste the signing secret into the account's **Webhook signing secret** field, and click **Save**.

### Configure Issue Fields{% #configure-issue-fields %}

Issue template fields define the data that is included when creating issues in Linear. For example, you can configure your template to create issues with a default assignee or specific labels.

### Validation{% #validation %}

1. Create an issue template.
1. Configure a monitor to with the Linear handle (for example, `@linear-my-issue-template-name`).
1. Send a test notification from the monitor and an issue should be created in Linear.

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

### Metrics{% #metrics %}

Linear does not include any metrics.

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

Linear does not include any service checks.

### Events{% #events %}

All created Linear issues appear as events within Datadog.

## Troubleshooting{% #troubleshooting %}

### Misconfigured Account{% #misconfigured-account %}

If you encounter errors when loading your issue templates, or receive `401` status codes from Linear in your event stream, reconnect your account following the steps below.



Do not delete the account in the Linear integration tile.

1. Navigate to your Linear workspace and go to **Settings**.
1. If the Datadog app is installed in your workspace, revoke access in **Applications**.
1. Go back to the [Datadog Linear integration tile](https://app.datadoghq.com/integrations/linear) and reauthorize the account by clicking **Add Account**.

The existing account in the integration tile should then be updated, and this can be verified by creating a new issue template for the account.

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