Setting Up Jira Integration in Insights

Connecting Jira with Insights allows you to track engineering productivity, including cycle times, issue progress, and delivery metrics, all in one place.

1. Navigate to Settings

Click the Settings icon in the bottom left of your sidebar.

2. Add Team Members

Inside the Settings page, navigate to the Members tab.

  • Click Add a new member to add the engineers whose cycle times and issue data you want to track.
  • Once members are added, you’ll be able to link them with their Jira accounts later in the process.

3. Open Jira Integration

Go to the Integrations tab and select Jira Integration.

4. Enter Jira Connection Details

Fill in the required fields:

  • Domain Name – Use the domain of your Jira Cloud or Jira Server instance (e.g., https://yourcompany.atlassian.net/).
  • Service Account – (Recommended) Create a dedicated service account in Jira with access to the projects you want Insights to analyze. Alternatively, you may use a personal access token.
  • API Token – Generate and paste the API token associated with your service account or personal account.

How to Get Your API Keys from Jira

a. Jira Workspace Name
Your Jira domain name is a unique identifier of your Jira project workspace. You can find this in the URL you use to access your Jira project. It often looks like https://[yourcompany].atlassian.net/.

b. Service Account
You will need an account that has project admin permissions for all Jira projects you want to integrate with.

c. API Token
Log into your Atlassian account → Profile dropdown → Manage Your Account → Security → Create and Manage API Tokens → Create API Token → copy and save.

💡 Tip: Using a service account is recommended for reliability and centralized control.

5. Configure Import & Webhooks

Enable the following options for a complete setup:

  • ✅ Import users from Jira → Ensures your Jira users are synced into Insights.
  • ✅ Automatically integrate with Jira webhooks → Allows Insights to update metrics automatically as activity occurs in Jira.

Alternatively, you can copy and paste the webhook link manually into Jira if you prefer.

6. Save Your Integration

Once all details are entered, click Save.

  • The initial connection may take a few minutes while Jira validates the service account or access token.
  • Once complete, Insights will begin importing data from your Jira projects.

After setup, return to the Members tab to ensure users are correctly mapped to their Jira accounts.

  • Click the Jira icon beside each user.
  • Link the Insights member profile with the correct Jira user account.

This ensures that productivity and delivery metrics are accurately attributed to each engineer.

8. Manual Jira Webhook Setup

If you need to set up Jira Webhooks manually (for the Story Points page):

  1. Head to the Integration page and click Manage Settings.
  2. Scroll down and select the Manual Webhook selector.
  3. Copy the URL present for the webhook.
  4. Head to your Jira instance and navigate to /plugins/servlet/webhooks and click Create a WebHook.
  5. Give your WebHook a name, paste the URL, and select the required events.
  6. Click Create to save the WebHook.

✅ Jira Integration Complete

Your Insights dashboard is now connected to Jira. You’ll start seeing data populate in areas like PR Cycle Time, Story Points, and Time in Status, giving you visibility into your team’s delivery flow.