Jira

Jira Help & Support

What JIRA Triggers and Actions Are Supported

Supported Triggers#

  • New Priority - Triggers when you add a new priority.
  • New Issue (Via JQL) - Triggers when a new issue is added that matches some JQL.
  • New Project - Triggers when a project is added.
  • New Issue Type - Triggers when you add a new issue type.
  • Updated Issue - Triggers when an issue is updated.
  • New Issue - Triggers when you add an issue to a project of your selection.

Supported Actions#

  • Add Watcher to Issue - Adds a user to the issue's watcher list.
  • Attach File to Issue - Attaches a file to an existing (or newly created) Jira issue.
  • Update Issue - Updates an existing issue.
  • Create Issue - Create a new issue, select your own project and issue type.

Supported Searches#

  • Find User - Find a user by name.
  • Find Issue - Searches for an issue, either using the issue's key, or its summary.

How to Get Started with JIRA on Zapier

The first thing you'll need to do is connect your JIRA Account to Zapier. After you sign up and start creating the Zap you want, Zapier will ask you to start the process:

Connect your JIRA account to Zapier

You can then give your Account a title or label, which is just for your convenience and helps you track multiple accounts. It doesn't have any affect on which Account you actually add to Zapier. You will also need to enter the full URL that your JIRA installation is running on along with an account username and password.

Note: In order to connect your JIRA account to Zapier, you will need full admin privileges along with API access. You can find out more about granting the correct permissions here.

Label your Wufoo account

Once your Account has been added and tested you'll see this if everything is good!

Account added and tested

Now you can continue creating your Zap.

Common Problems with JIRA

I use Google or some other SSO to login to JIRA, how can I connect my account to Zapier?#

If you use Google SSO, then you can connect to Zapier using the same guidelines outlined here, The only difference is that you'll want to use your full email for username, and the API token as the password. Other SSO services haven't been tested yet.

What versions of JIRA are supported on Zapier?#

Currently Zapier supports JIRA 6+. We support both JIRA Cloud and Server.

Help! I Cannot Connect With My Instance#

If you're seeing errors like this:

Max retries exceeded with url: /rest/auth/1/session (Caused by : [Errno -2] Name or service not known)

Then it is possible you have not opened up access to JIRA to the open internet for Zapier to connect. A common setup is for JIRA to be configured to only allow internal company traffic, which would mean Zapier would be unable to connect.

You'll need to make sure that Zapier's IP addresses are whitelisted. We use Amazon's AWS products for our server infrastructure, so you'll need to whitelist the IP list from the us-east-1 region.

AWS provides a list of their IP address ranges at https://ip-ranges.amazonaws.com/ip-ranges.json.

I'm getting a 401 Error#

For some instances of JIRA, you need to log in with your user name instead of your email. You can find your user name by going to your profile in JIRA.

I can't configure the Application URL#

The "accepted external application URLs" feature of JIRA/Atlassian products is not compatible with Zapier. Basically - if you are trying to connect via this page:

You are trying the wrong thing!

SSL Error (authorization failed: Could not verify SSL certificate)#

If you are running into the above error, it's likely your SSL certificate is not from a CA Zapier recognizes or has some issues. For more information please see our SSL guide here.

I want to send a link to the JIRA issue to my action app#

JIRA doesn't provide the URL as one of the fields, but you can build the URL yourself by combining the base URL and the Key field like so:

key

Some of my issue type's custom fields are missing#

This is a known bug in JIRA that you can track here.

My zaps are erroring out with a 301 error#

You'll need to reconnect your account and use 'https:' in the base url here:

The "Update Issue" action doesn't provide my custom fields if I'm using a custom issue key#

To remedy this:

  1. Choose any issue key from the Issue Key dropdown menu.

    • If the dropdown doesn't load any issues:
      • Select "Use a Custom Value (advanced)" from the Issue Key dropdown
      • In the Custom Value for Issue Key ID input box, type the key for a valid issue in your Jira account
      • Click the Refresh Fields button at the bottom of the screen. Your custom fields should now appear
  2. Map values into the fields as desired.

  3. Go back up to Issue Key dropdown and set it to use the issue key mapped in in the previous step.

    • You will see a warning about extra fields in the action—disregard this extra fields
  4. Turn on your Zap or test your action—the dynamically updated issue will get the values you've mapped.

Error: "Field '(some-field-name)' cannot be set. It is not on the appropriate screen, or unknown."#

You will need to go to the configurable screen for the project you have selected, to add this field. The URL will be something like this:
http://(your-subdomain).atlassian.net/plugins/servlet/project-config/(your-project-id)/screens

Error: "The issue type selected is invalid."#

JIRA might present you with multiple identical-looking Issue Types with different ID numbers, like this: duplicate issue types with different ID numbers

Clicking on the wrong Issue Type here will prevent the rest of your fields from loading, and you will not be able to create an issue. When you see this, click through the variations of the Issue Type that you want, until you see the rest of your fields load into the template in your Zap. This will help show you that you've selected the correct instance of the Issue Type for your project.

Need More Help? - Our support team is happy to help -- send us a message

Jira is a bug and issue tracking software tool that allows software developers to manage product development and build better software.

Getting Started with Zapier