> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# JIRA Cloud Write Back Connector

## Intro

Jira Software is part of a suite of solutions meant to assist teams of all sizes in managing their workload. Jira was originally intended to be a bug and issue tracker. Jira, on the other hand, has matured into a strong task management application for all types of use cases, ranging from requirements and test case management to agile software development. The JIRA Writeback connector allows users to write Domo data back into JIRA records in order to create or amend them.

You connect to your JIRA Cloud WriteBack account in the Data Center. This topic discusses the fields and menus that are specific to the JIRA Cloud connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

<table data-aura-rendered-by="33:201;a"><tbody><tr><td colspan="1" rowspan="1"><p><b><b> Primary Use Cases </b></b></p></td><td colspan="1" rowspan="1"><ul><li><p> Tracking progress and movement of tickets </p></li><li><p> Number of tickets assigned to specific users or groups </p></li><li><p> Seeing if too many tickets of a certain type are open (bugs) </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p><b><b> Primary Metrics </b></b></p></td><td colspan="1" rowspan="1"><ul><li><p> Bug / issue / ticket tracking (by age, type, status, submitter) </p></li><li><p> Completed tickets per team </p></li><li><p> Ticket resolution time </p></li><li><p> Project management metrics (tracking individual tasks of a larger project or epic). </p></li></ul></td></tr><tr><td colspan="1" rowspan="1"><p><b><b> Primary Company Roles </b></b></p></td><td colspan="1" rowspan="1"><p> Product managers </p></td></tr><tr><td colspan="1" rowspan="1"><p><b><b> Average Implementation Time </b></b></p></td><td colspan="1" rowspan="1"><p> This can vary wildly depending on the implementation and the user's level of knowledge of their JIRA system. </p></td></tr><tr><td colspan="1" rowspan="1"><p><b><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></b></p></td><td colspan="1" rowspan="1"><p> 7 </p></td></tr></tbody></table>

## Best Practices

* You should usually use
  **Replace** with the JIRA Cloud connector, as **Append** does not work well.
* If the query is for data across a long time period, scheduling should be kept to a minimum (once a day). For shorter queries, more frequent updates are appropriate.

## Prerequisites

To connect to your JIRA Cloud WriteBack account and create a DataSet, you must have:

* The domain of your JIRA Cloud account

You can authenticate to the JIRA Cloud Write Back connector with the same credentials you use to log into your Jira account online.

## Connecting to Your JIRA Cloud Write Back Account

This section enumerates the options in the **Credentials** and **Details** panes in the Jira Cloud Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your (third-party tool) account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Domain </td><td colspan="1" rowspan="1"> The domain of your JIRA Cloud account. Jira Server accounts are not supported for OAuth. </td></tr></tbody></table>

Once you have entered valid JIRA Cloud credentials, you can use the same account any time you go to create a new JIRA Cloud WriteBack DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector/Adapter Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector/Adapter Accounts").

### Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

The following reports are available:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:201;a"><thead><tr><th colspan="1" rowspan="1"><p> Report </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Create Or Update Issues </td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"> Update the Issue </td><td colspan="1" rowspan="1"> Update or change the issue in Jira. </td></tr><tr><td colspan="1" rowspan="1"> Get the Issue </td><td colspan="1" rowspan="1"> Retrieves the list of issues. </td></tr><tr><td colspan="1" rowspan="1"> Create Bulk Issues </td><td colspan="1" rowspan="1"> Create list of issues. <br /> The maximum limit for creating bulk issues are 50. </td></tr><tr><td colspan="1" rowspan="1"> Create Single Issue </td><td colspan="1" rowspan="1"> Create one issue at a time in Jira. </td></tr><tr><td colspan="1" rowspan="1"> Add Comment </td><td colspan="1" rowspan="1"> Add comment to an issue. </td></tr><tr><td colspan="1" rowspan="1"> Update Comment </td><td colspan="1" rowspan="1"> Update or change a comment to an issue. </td></tr><tr><td colspan="1" rowspan="1"> Create Issue Link </td><td colspan="1" rowspan="1"> Create a link for an issue in Jira. </td></tr><tr><td colspan="1" rowspan="1"> Search User </td><td colspan="1" rowspan="1"> Search for a specific user in Jira. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Create Or Update Project </td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"> Get Project </td><td colspan="1" rowspan="1"> Retrieve a project from Jira. </td></tr><tr><td colspan="1" rowspan="1"> Create Project </td><td colspan="1" rowspan="1"> Create a project in Jira. </td></tr><tr><td colspan="1" rowspan="1"> Update Project </td><td colspan="1" rowspan="1"> Update a project in Jira. </td></tr></tbody></table></td></tr></tbody></table>

## FAQ

<AccordionGroup>
  <Accordion title="What can I do with this connector?">
    You can use this connector to update your Jira issues or create new issues back to your source systems.
  </Accordion>

  <Accordion title="What is the authentication method for this connector?">
    JIRA uses basic authentication and personal access token based on the user selection.
  </Accordion>

  <Accordion title="How frequently will my data update?">
    Data from Jira's servers are usually made available to the API immediately.
  </Accordion>

  <Accordion title="Is there a support for paging for this connector?">
    This is not applicable for this connector.
  </Accordion>
</AccordionGroup>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").