Completing the Integration with Jira

This article provides information about specific setups required when configuring the BTS Connector with Jira.

Completing the Integration with Jira

This article provides information about specific setups required when configuring the BTS Connector with Jira.

  • Applause platform’s Jira Connector is compatible with Jira Software version 5.0 or above
  • Both Cloud and Server versions are supported
  • Other Jira products from Atlassian implementing the JIRA REST API version 5.0 or above, such as Jira Align and Jira Core, are supported as well


You’ll need the following in order to complete the Jira Connector configuration:

  • Jira REST API must be enabled
  • Jira user credentials (username, password):
    • User must be assigned visibility to the Jira project issues will be exported to
    • User must have Create and Save permissions
    • For easier tracking, use a dedicated user within your user system, named “Applause” or similar. This will help your teams to quickly locate issues exported from the Applause platform as opposed to those created directly in Jira

Note that only basic authentication is supported at this time.

  • Jira Project - The Connector is able to connect with a single project
  • For Jira Server - Make sure that the Applause platform can communicate with your Jira instance. Learn more about required configuration in case your Jira instance is behind a firewall here

Jira API Endpoints

If necessary, the following Jira API Endpoints need to be whitelisted:

  • POST /rest/api/2/issue/#id/attachments
  • POST /rest/api/2/issue
  • PUT /rest/api/2/issue/#id
  • GET /rest/api/2/issue/createmeta
  • GET /rest/api/2/user/assignable/multiProjectSearch
  • GET /rest/api/2/project/#projectId/statuses
  • POST /rest/api/2/issue/#id/comment
  • POST /rest/api/2/issue/#id/transitions
  • GET /rest/api/2/issue/#id
  • GET /rest/api/2/status/#statusId
Jira Connector

Once the BTS Integration was added, Jira was selected as the connector type and products were assigned, you’ll be required to provide the following information:

Jira Connector


Set your web-based access to Jira.


This is the username of the prerequisite Jira user.

  • Field is case sensitive
  • Jira username may be found in the user’s Profile page in Jira
  • Newer Jira implementations may be using Atlassian accounts (instead of Jira ones). The username for that is typically the first part of the email address before the “@” symbol. Jira usernames are seldom an email address
  • Important: If using an Atlassian API token for authentication, the user here the user’s email address

Password/API Token

This is the password or API Token of the prerequisite Jira user.

  • Field is case sensitive
  • Customers using Jira Cloud will need to provide an API Token in this field. Other Jira users will use a password

Project Key

This is the key of the prerequisite Jira project

  • Field is case sensitive
  • Project must be set on your Jira instance prior to setting the Connector

Issue Type

This is the default issue type for bugs sent from the Applause platform. Note that the integration currently does not support creating/updating Sub-Task issue types.

Notes and Tips

Note the following hints and tips while setting up the integration with Jira and hints on BTS general.

  • Learn more about working with the BTS Connectors as part of setting up the integration between the Applause platform and your Bug Tracking System (BTS) here
  • Learn more about integrating with your BTS here

  • The integration is already pre-configured to trust all SSL certificates from customer servers, even self-signed, so it’s possible to establish connection to any Jira instance with url starting with “https://”
  • In addition, there is an option to upload a client certificate generated as a collaboration between Applause and the customer. This X.509 SSL certificate requires Applause to first create a private key and a CSR (Certificate Signing Request) fulfilled by the customer. Please work with your Applause representative to complete the certificate prior to uploading it


When using the Labels field on field mapping please note:

  • Values are space-separated. You may send multiple labels on each exported issue
  • Values may include an Applause issue field to be dynamically populated, as well as plain text for fixed values


Starting 2019, Jira’s new issue view encodes URLs with special characters, which affects many Applause issue attachment URL links and causes an error upon clicking the link from within your Jira’s new view of an exported bug. Optional workarounds:

  • Revert your Jira back to the old issue view
  • Copy/paste the attachment URL to a new browser tab instead of directly clicking on the link

SNI (Server Name Indication)

If your Jira Server utilizes SNI make sure to enable this option. You may need to re-establish the connection to the server.

Two-way Jira Integration

Learn more about how to set up the Two-way Integration here.