> For the complete documentation index, see [llms.txt](https://docs.onum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onum.com/data-sinks/data-sink-integrations/send-data-to-jira.md).

# Send data to Jira

{% hint style="info" %}
See the changelog of the **Jira** Data sink type [here](/data-sinks-changelog/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**](/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](/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](/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.