This documentation was updated in November 2022 to reflect Jira's user interface changes. If, at the time of reading, you find that our instructions are no longer up-to-date, please let us know!

Jira is a tool used for project management. It centers around a ticketing system whereby features, chores, and bugs can be ticketed, tracked, and assigned.

AppSignal can be integrated into Jira for the automatic ticketing of incidents.

This documentation will guide you through the steps needed to integrate AppSignal into your Jira project.

Configure Jira

Before we can link AppSignal to Jira we need to configure Jira to accept our OAuth request.

To do this, click the settings cogwheel (⚙️) on the top-right of the navigation bar and select Products from the settings menu.

Article Illustration

Select "Application links" from the Products side navigation, then click "Create link".

Article Illustration

A pop-up will appear. In the Application URL field, add the address: https://www.appsignal.com

Article Illustration

Jira may show the error: "No response was received from the URL you entered". You may ignore this error and proceed by clicking "Continue"

You will next be presented with a Review Link screen. You only need to provide an Application name before continuing. Name the application: AppSignal, and press continue.

Article Illustration

OAuth Setup

Now it's time to configure AppSignal's "Incoming Authentication". To do this, navigate to "Edit" on the "Application links" screen:

Article Illustration

A "Configure AppSignal" pop-up will be opened. Navigate to "Incoming Authentication" on the left menu.

Article Illustration

In the "Incoming OAuth" tab, set up OAuth with the following values:

  • Consumer Key: ce2jejafmni3qmnzrfergg9fLpzxmppl
  • Consumer Name: AppSignal
  • Public Key:

Click "Save".

Configuring AppSignal

To complete the process of linking your Jira project to AppSignal, AppSignal must be configured to communicate with your Jira project.

To do this, open your application in AppSignal. Click "App settings" on at the bottom of the left-hand navigation pane and then click "Integrations":

Article Illustration

Navigate to "Personal issue tracker integrations" and click "Manage" for Jira. Alternatively, follow this link.

Article Illustration

Scroll down to "Jira installation location" and enter the URL of your Jira project, e.g.: project-name.appsignal.net, then click "link AppSignal to Jira.

Article Illustration

You'll be presented with the following authentication screen. Click: "Allow".

Article Illustration

You'll return to AppSignal. Here you need to select which project and issue type you want to use for AppSignal issues. To proceed, click: "create integration"

Article Illustration

If this step produces an error message, please read the errors section for further guidance.


AppSignal requires four fields to be present in Jira:

  • Labels
  • Environment
  • Summary
  • Description

AppSignal will show an error message on completion of setup if fields are missing and specify which ones must be added in Jira.

Article Illustration

You will have to add the fields to the Jira screens by going to the "Issues" tab in the "Settings" menu:

Article Illustration

Then navigate to the "Screens" on the left navigation pane and click on "Configure" for the relevant screen:

Article Illustration

On this "Configure" page Jira will present you with a list of already configured fields. Scroll to the bottom of the page and add the missing required fields.

Article Illustration

Once all fields have been created, you should be able to resume and complete the configuration your Jira integration from the AppSignal app.

Need Help?

If you've followed the steps on this page and are still getting stuck, feel free to contact us at support@appsignal.com.

Integrations list

Need more help?

Contact us and speak directly with the engineers working on AppSignal. They will help you get set up, tweak your code and make sure you get the most out of using AppSignal.

Contact us

Start a trial - 30 days free

AppSignal is a great way to monitor your Ruby, Elixir & Node.js applications. Works great with Rails, Phoenix, Express and other frameworks, with support for background jobs too. Let's improve your apps together.

Start a trial