Common Problems with Jira Software Server

I can't connect to my Jira Software Server account

If you're running into an error that says "Your Jira Software Server credentials are invalid, or have been temporarily disabled by Atlassian", this is likely due to 2FA being enabled on your Jira Software Server account. You’ll need to disable 2FA on your Jira Software Server account as the current Jira Software Server integration doesn't support their 2FA authentication flow. In the case that you're using Google and 2FA to log into Jira Software Server, please try logging in with your full email address and an API token instead of a password.

I use Google or some other SSO to login to Jira Software Server, 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 Software Server are supported on Zapier?

Currently Zapier supports Jira Software Server 6+. We support both Jira Software Server 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 Software Server to the open internet for Zapier to connect.
A common setup is for Jira Software Server 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 allowed. We use Amazon's AWS products for our server infrastructure, so you'll need to allowlist 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 Software Server, 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 Software Server.

I can't configure the Application URL

The "accepted external application URLs" feature of Jira Software Server/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 Software Server issue to my action app

Jira Software Server 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:

Some of my issue type's custom fields are missing

This is a known bug in Jira Software Server 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 Software Server 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
     
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 Software Server might present you with multiple identical-looking Issue Types with different ID numbers, like this:

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.