What can we help you with?

Jira Cloud Integration

Screen_Shot_2020-03-15_at_15.57.05.png

Need a way to manage tasks, issues, bugs in your Jira Cloud and monday.com? Now you can with our Jira integrated monday.com automations!

 

How to add an integration? 

Step 1
 
To add an Integration, go to the board you want to create an Integration for and click on the Integration button, located on the upper right of your screen as below: 
 
integration.png
 
Once on the page, you will see all of the amazing apps we offer to integrate with, then go ahead and select "Jira": 

integrations.png

 

Step 2

From the list, select the recipe you want to add-

image_104__1_.png

 

Step 3 

Connect your Jira account with the Jira token to monday.com-

image_107.png

 

How to get/create JIRA API token?

  • Step 1

When in Jira, go to Profile > Manage Profile

2.png

Next, click on security and select Create and Manage API tokens

1.png 

  • Step 2

Create an API token and enter a label to save -

3.png

  • Step 3

Copy the token to enter into the automation setup within your monday.com account. It's that easy!  

 

How to customize the integration?

Once the token is added, you can customize your recipe any way you want with the applicable fields. For example, when an issue is created in a project in Jira, you can create an item on your board and sync future changes from Jira-

Jira_Sync_Future_Changes_2.gif

You can also set a reminder if you want to update your team members with a summary of an issue in your projects in Jira- 

JIRA_Reminder.gif

Note: The JIRA integration doesn't work retroactively. It will pull in only new issues, epics, etc. created in JIRA.

 

Creating a two-way sync

A two-way sync occurs when data is being both pushed from monday.com into Jira and pulled from Jira into monday.com. This makes it so that your data matches in both platforms and remains up-to-date.

To create a two-way sync, in addition to the recipe used in the first example: "When an issue is created in this project, create an item and sync future changes from Jira"

You'll need to set up the following recipe: "When an item is created or updated, create an issue in this project of this type with these fields, and sync all future changes from this board"

Frame_114.png

Choose the correct project. In this case, we're going to use "KB Iteration Planning" again. For the type, we're also going to choose "Task" again.

Frame_115.png

After choosing your project and type, select "these fields" to begin mapping. 

With this recipe, when we’re mapping, the fields to the left are Jira data fields rather than the names of your monday.com columns. Here you’re mapping monday.com columns into Jira. It’s the reverse of the set up we walked through earlier in this article.

Frame_116.png

Once you finish mapping and click the "Add To Board" button, your two-way sync is ready to go!

 

Note: In Jira, there are certain field types that are required for an issue type. For this recipe to work, the fields required in Jira for your chosen issue type must be mapped in your monday.com integration. If those required fields are left blank, the integration will not work. There will not be an error message to indicate that the integration hasn't worked. The Jira admin can set the required fields within Jira. 
 

How to delete it?

You can turn off and/or delete your integration in the integration menu- 

Frame_83.png

You can also edit the integration and the Jira account you want to connect it to in case you change your mind later!

 

Supported Fields for Mapping 

  • Currently, the following fields are supported for mapping the integration between JIRA and monday.com: issuekey, issuetype, project, string, priority, user, status, option, resolution, number, watches, datetime, date, progress, and votes. 
  • All Jira custom fields can be mapped into a status column in monday.com, as long as the custom field type is one that is supported (see above). 
  • The following fields are supported for mapping the integration from monday.com to Jira (the reverse of the above): string, priority, option, number, datetime, and date.
 
Note: At the moment, next-generation projects are not supported. 

 

More assistance

If you need help building custom integrations, we also have an option for paid assistance through our network of certified monday.com partners. If you're interested, please fill out this form and someone will be in touch shortly!

 

And if you have any questions about this or anything else in this article, feel free to reach out to us at customer success at [email protected]