Connect Jira to Hoopla

About the Jira integration

The Jira connector enables Hoopla customers to pull data from their Atlassian Jira Cloud instance for use in metric mapping, newsflashes, and user sync. It supports OAuth2 authentication to connect your Jira site securely.

Features

Supported

• OAuth2 authentication via Atlassian

• Metric mapping — count, sum, and average aggregations on issue data

• Filters on issue attributes: assignee, reporter, creator, project, status, issue type, priority, created/updated/resolution/due dates, time estimates, time spent, story points

• Newsflash triggers — fire a newsflash when issues match a configured filter

• Team sync — sync Jira projects into Hoopla as teams, with assigned users synced as team members (plus on-demand sync when an assignee surfaces in a metric/newsflash result) for metric attribution and leaderboards

• Time-range filters — built-in timespans (today, yesterday, this week/month/quarter/year, last week/month/quarter)

Not yet supported

• Cycle time (per-ticket date-difference calculations)

• Reopened tickets (requires Jira changelog API)

• Sprint filters (no sprint in openSprints() JQL support)

• Worklog entity

Setup

Enable the integration

Contact support to enable the Jira integration for your account.

Authorize the integration

From the Hoopla Integrations settings page:

1. Click the Jira tile.

2. Follow the redirect to the Atlassian OAuth consent screen.

3. Select the Jira site to authorize.

4. Return to Hoopla. The connection shows the name of the user who authorized it.

Sync Jira projects as teams

Select the Jira projects you want to sync into Hoopla as teams.

Create a dataset

After a Jira project is synced into Hoopla as a team, you can create a dataset for metric mapping. The dataset defines which entity to query (e.g. issue) and any base filters that apply across all mappings derived from it.

From the Integrations → Jira → Datasets page:

1. Click New Dataset

2. Enter a name (e.g. “All Open Bugs”)

3. Select the issue entity

4. (Optional) Add base filters that scope every mapping using this dataset

5. Save

The Project field is required. Select the same project as the team you just synced.

Create a metric mapping

From the Metrics page:

1. Choose Jira as the data source

2. Select an existing Jira dataset (created in step 4)

3. Configure key attribute (e.g. assignee), value attribute (e.g. story_points), and aggregation type

4. Add filters (e.g. status = “Done”, created in this_month)

5. Save — the mapping runs on the configured sync interval

Once metric mapping is set up, the Jira connector automatically syncs Jira users into Hoopla.

Create a newsflash mapping

Create a separate dataset for newsflashes. For example: Create a dataset with Project = ‘Some Project’ and status = ‘In Progress’, which will create a newsflash that tracks issues updated since the previous sync. (On the first run it baselines against the last 365 days; after that it only picks up issues changed since the last successful run.)

Add Jira metrics to Hoopla channels

Go to the Channels page and add leaderboards or newsflashes that use your Jira metrics.