# Send data to Jira

{% hint style="info" %}
See the changelog of the **Jira** Data sink type [here](/data-sinks/jira-data-sink.md).
{% endhint %}

## Overview

Onum supports integration with [Jira](https://www.atlassian.com/software/jira).

Jira is a software application developed by Atlassian that is primarily used for issue tracking, project management, and bug tracking. It provides a platform for teams to plan, track, and manage their work, particularly in software development, but also in other industries. 

## Prerequisites 

* You must have access to a **Jira Cloud** or **Jira Server / Data Center** instance.
* You'll need to know your **Jira base URL.**
* A User Account with **API Acces.**

## Onum Setup

{% stepper %}
{% step %}
Log in to your Onum tenant and click **Data Sinks> New Data sink**.
{% endstep %}

{% step %}
Double-click the **Jira** Sink.
{% endstep %}

{% step %}
Enter a **Name** for the new Data Sink. Optionally, add a **Description** and some **Tags** to identify the Sink.
{% endstep %}

{% step %}
Decide whether or not to include this Data sink info in the metrics and graphs of the [**Home**](/the-workspace/home.md) area.
{% endstep %}

{% step %}
Connect to your Jira instance using

* The Jira API **URL**<mark style="color:red;">**\***</mark>. This will be in the following format:\
  \
  `https://<your_atlassian_site_name>.atlassian.net/`
* The **Username**<mark style="color:red;">**\***</mark> that will be used for basic authorization.
* Allow scripts to access REST APIs for Atlassian cloud products using the[ Jira API Token](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/). Create a [secret](https://docs.onum.com/administration/tenant-menu) containing your API token or select one already created
  {% endstep %}

{% step %}
Set a **Rate Limit** on the **Maximum requests per second**<mark style="color:red;">**\***</mark>  to launch on the server. The minimum value is `1` and the maximum value is `10`.
{% endstep %}

{% step %}
If you are using a proxy to establish the connection, toggle on the **Proxy configuration** button and enter the details here. See how to create them as secrets below.

<table><thead><tr><th width="169.73046875">Parameter</th><th>Description</th></tr></thead><tbody><tr><td><strong>Scheme</strong><mark style="color:red;"><strong>*</strong></mark></td><td>Choose the scheme to connect to.</td></tr><tr><td><strong>Host</strong><mark style="color:red;"><strong>*</strong></mark></td><td>The host of the proxy URL used to establish the connection</td></tr><tr><td><strong>Port</strong><mark style="color:red;"><strong>*</strong></mark></td><td>The port of the proxy URL used to establish the connection</td></tr><tr><td><strong>Username</strong></td><td>This is the username used to access the proxy.</td></tr><tr><td><strong>Password</strong></td><td>Enter the proxy passcode</td></tr></tbody></table>
{% endstep %}

{% step %}
Click **New secret** to create a new one:

* Give the secret a **Name**.
* Turn off the **Expiration date** option.
* Click **Add new value** and paste the corresponding value.
* Click **Save**.

<figure><picture><source srcset="/files/NeeWsSQzoChVxRIY76Nt" media="(prefers-color-scheme: dark)"><img src="/files/1oTccyPmgZJ1laY7IhZH" alt=""></picture><figcaption></figcaption></figure>

{% hint style="info" %}
Learn more about secrets in Onum in [this article](/administration/global-settings/organization-settings/secrets-management.md).
{% endhint %}

You can now select the created secrets in the configuration.
{% endstep %}
{% endstepper %}

Click **Finish** when complete. Your new Data sink will appear in the **Data sinks** area list.

## Pipeline configuration

When it comes to using this Data sink in a [Pipeline](/the-workspace/pipelines.md), you must configure the following output parameters. To do it, simply click the Data sink on the canvas and select **Configuration**.

### Output configuration

* Enter the Jira **Project**<mark style="color:red;">\*</mark> key.
* Choose the field that contains the Jira **Issue type**<mark style="color:red;">\*</mark>.
* Choose the field that contains the Jira issue **Summary**<mark style="color:red;">\*</mark>.
* Optionally, choose a field with a **Description** for the Jira issue.

Click **Save** to complete the process.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onum.com/the-workspace/data-sinks/data-sink-integrations/send-data-to-jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.