Stitch Documentation
has moved!

Please update your bookmarks to

If you're not automatically redirected after 5 seconds, click here.

Connecting JIRA

To connect your JIRA data to Stitch, you'll need to do the following:

  1. Whitelist the Stitch IP addresses *
  2. Verify your protocol support *
  3. Retrieve the Stitch Public Key
  4. Grant Stitch application access to JIRA
  5. Complete the setup in Stitch
  6. Define the Replication Frequency

* These steps only need to be completed if you're using a self-hosted (on-site) version of JIRA.


You need JIRA Administrator permissions to complete the second step of this process.

Whitelisting the Stitch IP Addresses

If your JIRA instance is both self-hosted AND behind a firewall, you’ll need to whitelist the Stitch IP addresses to successfully connect to Stitch. Whitelist all of the following IP addresses:


Be sure to do this before continuing through the rest of the setup or you may encounter errors when saving the integration.

Verifying Your Protocol Support

If your JIRA instance is self-hosted, you'll also need to verify that your server uses HTTPs as the protocol. Stitch does not support HTTP for security reasons.

When you complete the JIRA setup in Stitch, you'll be asked to enter your JIRA base URL. If Stitch determines that the protocol is not HTTPs, connection errors will arise.

Retrieving the Stitch Public Key

  1. From the Stitch Dashboard page, click the Add an Integration button.
  2. Click the JIRA icon. This will open the JIRA credentials page.
  3. Take note of the Public Key field. We’ll need that to set up the application access in the next step.

Leave this page open for now and open another tab in your browser.

Granting Stitch Application Access to JIRA

Note that you need Administrator permissions to complete the steps in this section. If you're not an Admin, loop in someone who can help you before continuing.

If you need some visual help, click the GIF to the right for a closer look.

Navigating to the Application page in JIRA
  1. In the new tab, sign into your JIRA account.
  2. Click the Settings (gear) icon in the top-right corner.
  3. In the dropdown, click Applications.
  4. Click Application links - it’s in the Integrations section of the menu on the left side of the page.
  5. In the Application field, enter
  6. Click Create new link.

A few ‘Configure Application URL’ messages might display after clicking the Create new link button. If you see these, don’t worry - everything is still on track. Click Continue to keep going.

Defining the First Set of Link Application Settings

The screen cap to the right is how your Link Application settings should look when finished. Click the image for a closer look.

Defining the JIRA Link application settings, round 1
  1. A Link Applications window will display.
  2. Enter rjmetrics in the following fields:
    - Application Name
    - Service Provider
    - Consumer Key
    - Shared Secret
  3. If the Application Type field doesn’t default to Generic Application, change it to this setting.
  4. Enter in the following fields:
    - Request Token URL
    - Token URL
    - Authorize URL
  5. Check the Create incoming link box.
  6. Click the Continue button and a second Link Applications window will display.

Defining the Second Set of Link Application Settings

The screen cap to the right is how your Link Application settings should look when finished. Click the image for a closer look.

Defining the JIRA Link application settings, round 2
  1. In this window, enter rjmetrics in these fields:
    - Consumer Key
    - Consumer Name
  2. In the Public Key field, paste the entire public key from the Stitch JIRA credentials page.
  3. Click the Continue button.
  4. If the link configuration was successful, you’ll see a Success! message on the Configure Application Links page.

We’re almost finished. The last step is to name the connection and enter your JIRA URL in Stitch.

Completing the Setup in Stitch

In Stitch, complete the following in the JIRA credentials page:

  1. Enter a name for the integration. This is the name that will display on the Stitch dashboard for the integration; it’ll also be used to create the schema in your data warehouse.

    For example, the name “Stitch JIRA” would create a schema called stitch_jira in the data warehouse.
  2. In the Base URL field, enter the base URL for your JIRA site. Remember: if you're connecting a self-hosted instance, your server must use the HTTPs protocol or Stitch will be unable to successfully connect.
  3. Click the Save Integration button.

Defining the Replication Frequency

The replication frequency setting determines how often Stitch will attempt to replicate data from JIRA. By default the Replication Frequency is set to 30 minutes, but you can change the interval to better suit your needs.

You can change this setting at any time by clicking into the integration from the dashboard and then clicking the Integration Settings button.

Now you can sit back and relax while Stitch replicates your JIRA data to your data warehouse.


Was this article helpful?
0 out of 0 found this helpful


Questions or suggestions? If something in our documentation is unclear, let us know in the comments!