Setting up Connection for qTest Integration with JIRA Server


»Install qTest for JIRA Add-on

»Set up Connection from qTest to Jira


If you are using qTest On-Premise, please disregard these requirements, assuming qTest On-Premise and JIRA Server are located on the same network and able to connect to each other using the specified ports

Prerequisites for qTest Cloud + JIRA Server


The below is required for you to establish a connection between qTest Cloud and JIRA Server.  Please verify that you have access to the below before proceeding. This may involve incorporating your IT Infrastructure team to help with connection. 

  • JIRA Admin Account to set up web hook integration 
  • Access to INSTALL qTest for JIRA add-on Add-on into their JIRA Server 
  • Access to Configure your firewall's settings to accept accesses/requests from the following specific Amazon servers elastic IP addresses
  • Access to allow JIRA Server to be PUBLIC to qTest Amazon elastic IP addresses

JIRA Admin and Server Actions Needed

  1. Make sure your JIRA server's IP address is configured to be a public IP address, so that your JIRA instance is accessible from the public.   
  2. Configure your firewall's settings to accept accesses/requests from the following  specific Amazon servers' elastic IP addresses. This must be a Bi-directional set up accepting inbound and outbound requests between the qTest Amazon Elastic IPs and your JIRA Server:
  3. If your JIRA Server protocol is http (80. 8080) or https (443), please make sure you are also opening up the correct ports.  


Check out our FAQs for JIRA troubleshooting and Permissions Issues needed for JIRA troubleshooting if you ever encounter an issue.

Install qTest for JIRA Add-on

To set up integration with JIRA Server, you are required to install qTest for JIRA Add-on on your JIRA Server instance to initiate integration with qTest.

This add-on will provide the following functions:

  • Detect JIRA settings which are to be used for managing defect and requirement integration in qTest.
  • Constantly sends requests from JIRA to qTest to update integrated qTest requirements' fields based on changes made in JIRA.
  • Support pre-filling selected data of qTest test run to a JIRA issue ticket during test execution.
  • Display Test Run execution Status on the JIRA Defect reported


If you set up connection with JIRA Server in qTest without installing qTest for JIRA Add-on, you cannot save connection as it keeps showing an "Upgrade Reminder pop-up"


  1. Login to JIRA with Global Administrator account
  2. Select Add-ons from the JIRA Administration Session. Refer HERE for how to access JIRA Administration
  3. Click Find new add-ons in the Atlassian Marketplace for JIRA
  4. In the "Search the Marketplace" box, enter "qTest for JIRA" and search
  5. Click Install on the qTest for JIRA Server Add-on in the Search results.

  6. Click Manage Add-ons to check if qTest for JIRA Add-on is successfully installed on your JIRA Server. 
  7. Go to qTest Integration Settings to set up Connection with JIRA

Set up Connection from qTest to JIRA

A. Set up Connection using JIRA Username and Password

    1. Login to qTest with a Project Administrator account and access Integration Settings. Select JIRA 4.4+ in the left External Systems list                     
    2. Click Add Connection button 
    3. Enter Connection Name, JIRA Server URL, Username & Password
    4. Click Test Connection, then Save & Configure to startconfiguration for Defects and Requirements Integration

    5. After configuring Defect and Requirement Integration, click Save & Activate button 
    6. Click Refresh button in the Confirmation pop-up to switch to your integrated tracker system


    7. After your integrated connection is successfully activated, it will be notified with a green status label "in use" next to JIRA 4.4.x, and the Defect menu will be hidden. Thus, the only way to submit defect is through Test Execution.


    8. To edit a connection, click Configure  icon on that Connection in the list.

B. Set up Connection using JIRA OAuth Token

Create qTest Application Link in JIRA:

  1. On your JIRA instance, create a new application link using your qTest instance's URL
    JIRA - Application link - Create
  2. After the link has been created, configure it. On Configure dialog, select tab Incoming Authentication and enter the following information: JIRA - Public Key

On qTest side, add a connection to your JIRA instance:

  1. Click Add Connection button
  2. Enter Connection Name and Server URL of your JIRA instance
  3. Click Use JIRA OAuth URL
  4. Click Authorize URL. From the JIRA authorize page, get the verification code
  5. Back to the Add JIRA Connection dialog on qTest, enter the Verification Code
qTest - Integration Settings - Add Connection - Use JIRA OAuth