Overview
Pensero connects to your Jira workspace to access work items such as tasks, bugs, user stories, and epics. This allows Pensero to analyze engineering activity and understand the effort and complexity behind each contributor’s work. Pensero processes only work-related content and does not access unrelated information.
Admins can connect Jira workspaces from the Integrations section by following the steps below.
What Pensero reads from Jira
Pensero ingests metadata only. It does not store or access source code.
From each Jira issue, Pensero reads:
Content: Description text and ticket details
State: Workflow status (e.g., open, in progress, closed)
Creator & Assignee: Users linked to the ticket
Original ID & Key: Unique identifiers
Score: A computed metric based on completeness and interactions
Linked Pull Requests and Documents: Cross-tool connections
Pensero supports organizations that operate multiple Jira workspaces within the same company, enabling centralized and consistent delivery analysis.
What Pensero calculates from Jira
Pensero derives delivery insights by analyzing:
Jira issues
Related pull requests
Related documents
Slack or ticket comments
For a full breakdown of scoring logic, refer to the Delivery Calculation documentation.
Add your Jira workspace (Step-by-Step)
Step 1 - Go to Integrations and Click “Connect”
Open the Integrations page from the left sidebar, find Jira in the list of integrations and select Connect to begin the setup.
Step 2 - Complete Jira Authentication
Follow Jira's OAuth prompts and grant the required permissions.
Step 3 - Sync Your Workspace
Pensero will sync data automatically. Permissions can be adjusted at any time from your Jira Account Settings. Please allow a few hours for the initial sync to complete and for insights to appear accurately in your dashboard.
Here is the updated section to add to the Jira Help Center article:
Connect Jira using an API token
In addition to OAuth, Pensero can connect to Jira using an API token. This option is useful when you want to control the connection manually or limit the sync to specific Jira projects.
Step 1 - Select API token connection
Go to Settings → Integrations, find Jira, and click the dropdown next to Connect.
Select Connect using API Token.
Step 2 - Create a Jira API token
From your Atlassian account:
Go to Account settings > Security tab > API tokens
Click Create API token
Give the token a clear name, for example Pensero
Select an expiration date
Click Create
Copy the API token
Important: Atlassian only shows the token once. Copy it and store it securely before closing the page.
Step 3 - Find the Jira project keys you want to sync
If you only want Pensero to sync specific Jira projects, add the project keys during setup.
To find project keys in Jira:
Go to your Jira projects page
Review the Key column
Copy the project key for each project you want Pensero to ingest
For example, if the Jira project key is KAN, enter KAN in Pensero.
If you want to include multiple projects, separate the keys with commas.
Example:
ENG,KAN,PLAT
Step 4 - Complete the connection in Pensero
In the Pensero Jira API Token setup form, enter:
Email
The email address associated with the Atlassian account that created the API token.API Token
The API token copied from Atlassian.Projects, optional
The Jira project keys you want Pensero to sync. Leave this blank if you want Pensero to sync all accessible projects.
Then click Connect Jira.
Step 5 - Review and update the configuration
After the connection is created, you can review or update the setup from the Jira integration settings.
Go to Settings → Integrations → Jira → Manage.
From there, you can review:
The Jira connection type
The connected workspace or subdomain
The email used for the connection
The API key field
The project keys configured for sync
If you need to change which Jira projects Pensero syncs, update the Projects field with the correct project keys and click Submit.
Notes on project filtering
The Projects field is optional.
Leave it blank to sync all Jira projects available to the connected account
Add one project key to sync only that project
Add multiple project keys separated by commas to sync a selected set of projects
Make sure the Atlassian account used for the API token has permission to access the projects you want Pensero to sync. If the account does not have access to a project, Pensero will not be able to ingest that project’s tickets.