Tools Connect: Jira

Allstacks integrates with Jira Basic and OAuth to ingest tickets, stories, epics, releases, and related activity such as status changes, estimates, and comments. This enables a unified, read-only view of your engineering work across tools.

Note: Allstacks’ integration is strictly read-only. We do not create, assign, update, or delete any data in Jira.

Prerequisites

Before you begin:

• Sign into Jira with the account you intend to connect.

  • We strongly recommend using a dedicated service account to ensure the integration remains stable if individual users are offboarded or their roles change.

• The Jira account must have the following permissions:

  • Browse Projects

  • Create Issues

  • Edit Issues

You may need help from your Jira admin to confirm or assign these permissions.

You may also reference Jira documents to asisst you: Jira Tutorials for Guides & Permissions | Atlassian

Choosing a Connection Method

Connect Using Basic Auth (API Token)

Steps

1. Log in to Jira with the service account you intend to connect.

2. In Allstacks, go to:
   Tools > Add Tool > Jira (Basic)

3. Click Get your API Token here to open Jira in a new tab.

4. In Jira:

   • Generate a new API token.

   • Name it “Allstacks”.

   • Copy the token.

5. Back in Allstacks:

   • Paste the API token.

   • Enter your Atlassian site name and email address.

6. Click Add Tool.

Open

If the resource list appears empty, click Refresh Resources.

Open

Connect Using OAuth (Application Link)

OAuth is recommended for long-term or production use. A Jira site admin is required to complete this setup.

Step 1: Prepare in Allstacks

1. In Allstacks, go to:
   Tools > Add Tool > Jira (OAuth)

2. Enter your Jira base URL:

   • Cloud: my-org.atlassian.net

   • Server/DC: jira.example.com

3. Click Generate Keys

4. Copy:

   • Consumer Key

   • Public Key

   • Callback URL (/service/JiraConnector/auth-finish)

Open

Step 2: Configure Application Link in Jira

Jira Cloud Navigation

• Go to: Settings > Products > Application Links

Jira Server/Data Center Navigation

• Go to: Settings > Applications > Application Links

Config steps

1. Create a new application link using your Allstacks instance URL (e.g., https://app.allstacks.com)

2. If you get a "No response received" warning, click Continue

3. In the Review Link dialog:

   • Application Name: “Allstacks”

   • Click Continue

4. Edit the new link → Incoming Authentication

   • Fill in:

     • Consumer Key

     • Public Key

     • Callback URL

     • Consumer Name (e.g., “Allstacks”)

   • Save

Step 3: Complete OAuth Flow

1. Return to Allstacks.

2. Click Add Tool.

3. When redirected to Jira, log in as the service account, and click Allow to authorize.

Authentication Notes

Jira Cloud

• Uses email + API token (Basic Auth)

• API tokens expire after 365 days

Jira Server / Data Center

• Supports Basic Auth or OAuth via Application Link

Reauthentication & Updates

Basic Auth

• To update the token:

  1. Enter the new token and click Save

OAuth

• To re-authenticate:

  1. Log in to Jira with the correct service account

  2. In Allstacks, open the tool and click Re-Auth

Switching Authentication Methods & Migrations

• Small datasets: Create a new connection and remove the old one once sync completes

• Large/Enterprise datasets: Contact Allstacks support to coordinate the change

• Switching from Jira Server to Jira Cloud requires creating a new connection in Allstacks.