Skip to content
TeamLoop

Jira Integration

Connect Jira to search issues, epics, sprints, and comments across your projects.

What You Can Query

Section titled “What You Can Query”
Content TypeDescription
IssuesBugs, tasks, stories, subtasks
EpicsLarge feature groupings
SprintsIteration content and goals
CommentsDiscussion threads on issues
ChangelogsStatus, assignee, priority history

Connecting Jira

Section titled “Connecting Jira”

Jira uses an Atlassian connection shared with Confluence. One connection enables both integrations.

  1. Log into TeamLoop at app.teamloop.io
  2. Navigate to Settings > Integrations
  3. Click Connect next to Atlassian
  4. Enter your Atlassian email, API token, and site URL (e.g., yoursite.atlassian.net)
  5. TeamLoop validates the credentials and saves them encrypted

If you already connected Atlassian for Confluence, Jira is automatically available.

Creating an Atlassian API Token

Section titled “Creating an Atlassian API Token”
  1. Go to id.atlassian.com/manage-profile/security/api-tokens
  2. Click Create API token
  3. Give it a label (e.g., “TeamLoop”)
  4. Copy the token
  5. In TeamLoop, enter your Atlassian email, the API token, and your site URL

Your API token provides read access to all Jira projects your Atlassian account can access. We never write to your Jira instance.

Example Queries

Section titled “Example Queries”

Search Issues

Section titled “Search Issues”
teamloop_query:
  query: "authentication bug"
  sources: "jira"

Find Sprint Work

Section titled “Find Sprint Work”
teamloop_query:
  query: "current sprint backend team"
  sources: "jira"

Track an Epic

Section titled “Track an Epic”
teamloop_query:
  query: "user onboarding epic"
  sources: "jira"

Automatic Change Tracking

Section titled “Automatic Change Tracking”

TeamLoop automatically tracks changes from Jira. Jira provides one of the richest changelogs of any integration.

Issue Timeline

Section titled “Issue Timeline”

When you query an issue, TeamLoop fetches its full changelog:

  • Status changes (To Do → In Progress → In Review → Done)
  • Assignee changes
  • Priority changes
  • Sprint changes (moved between sprints)
  • Label changes
  • Story point updates
  • Fix version changes
  • Component changes

This rich changelog makes Jira especially powerful for temporal queries.

Entity Extraction

Section titled “Entity Extraction”

Jira content maps to TeamLoop entity types:

Jira ContentTeamLoop Entity
IssueDOCUMENT
EpicPROJECT
SprintPROJECT
CommentDOCUMENT
AssigneePERSON
Status changeCHANGE
Priority changeCHANGE

Temporal Queries with Jira

Section titled “Temporal Queries with Jira”

Point-in-Time

Section titled “Point-in-Time”

See the state of Jira issues on a specific date:

teamloop_query:
  query: "authentication project"
  sources: "jira"
  mode: "as_of"
  as_of: "2024-06-01"

Evolution

Section titled “Evolution”

Track how an epic progressed over a quarter:

teamloop_evolution:
  query: "onboarding epic"
  from_date: "2024-01-01"
  to_date: "2024-03-31"

Troubleshooting

Section titled “Troubleshooting”

No Results

Section titled “No Results”
  • Verify the Atlassian integration is connected
  • Check that your Atlassian account has access to the Jira project
  • Ensure issues aren’t in restricted projects
  • Try broader search terms

Missing Issues

Section titled “Missing Issues”
  • Check project permissions in Jira
  • Verify your Atlassian account has the correct role
  • If project access changed recently, your existing API token should reflect new access automatically

Security

Section titled “Security”
  • API tokens are encrypted at rest using pgcrypto
  • Accesses all Jira projects your Atlassian account can see
  • You can revoke the token at id.atlassian.com/manage-profile/security/api-tokens
  • TeamLoop never writes to Jira
  • You can disconnect at any time from TeamLoop settings

Next Steps

Section titled “Next Steps”