> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/integrations/jira-integration.md).

# Jira Integration

Create Jira issues from Telmai incidents, by hand or automatically.

Connect your Jira instance to Telmai to create and track Jira issues for data quality incidents. Issues can be created by hand from an incident, or automatically when a monitor opens one.

## Connect to Jira

Only tenant admins can set up the Jira integration.

1. Open **Administration** and, under **Integrations**, select **Jira**.
2. Choose how to connect: **OAuth** (recommended) or **API token**.
3. With **OAuth**, click **Continue to Jira**. You're redirected to Jira to sign in and approve access.
4. With **API token**, enter the **Jira URL**, **Email** and **API token**, then click **Connect**.

Once connected, the setting shows **Jira is connected to this tenant.** To remove the integration, click **Disconnect**.

{% hint style="info" %}
Only one ticketing system can be connected at a time. If ServiceNow is connected, disconnect it before you set up Jira.
{% endhint %}

## Create ticket templates

Ticket templates set the Jira project, issue type and fields of the issues Telmai creates. They're useful when your Jira projects require specific fields, and they're required for automatic ticket creation.

1. Open **Administration** > **Jira**. Templates are in the **Ticket templates** section, once Jira is connected. You can also click **Manage templates** in a monitor's **Create a ticket** step.
2. Click **New template**.
3. Enter a **Name** and, optionally, a **Description**.
4. Choose the **Jira project** and **Issue type**. Fields that the issue type requires appear under **Custom fields**.
5. Add more fields with **Add field**.
6. Click **Create**.

## Create Jira issues

{% hint style="info" %}
Telmai creates Jira issues and links them to incidents. It doesn't resolve or close the issues in Jira.
{% endhint %}

### Automatically, from a monitor

To have a monitor create a Jira issue whenever it opens an incident:

1. Open the asset's **Monitors** tab and click **View** on the monitor, then **Edit**. For a new monitor, click **New monitor**.
2. In the **Create a ticket** step, check **Create ticket automatically** and choose a **Template**.
3. Click **Save**.

To set this up on several monitors at once, select them and use the **Ticketing** bulk action. See [Managing Existing Monitors](https://docs.telm.ai/telmai/monitoring-data/monitors-management/managing-existing-monitors.md#change-several-monitors-at-once).

### By hand, from an incident

1. Open [Incidents](https://docs.telm.ai/telmai/monitoring-data/incident-portal.md) from the side menu.
2. Click **Create ticket** in the incident's **Ticket** column, or in the **Metadata** section of the incident's details.
3. In **Create Jira issue**, choose a **Template (optional)**, or the **Jira project** and **Issue type**. Telmai fills in the **Summary** and **Description**; edit them if you need to.
4. Click **Create ticket**.

The issue's key then appears in the incident's **Ticket** column and details; click it to open the issue in Jira. To remove the link, use **Unlink ticket** next to the key.

{% hint style="info" %}
You can create an issue only for an open incident that doesn't have one yet.
{% endhint %}

## Related

* [Creating a Monitor](https://docs.telm.ai/telmai/monitoring-data/monitors-management/creating-a-monitor.md)
* [Incidents](https://docs.telm.ai/telmai/monitoring-data/incident-portal.md)
* [Ticket Integration API](https://docs.telm.ai/telmai/api-reference/ticket-integration-api.md)
