Jira is Atlassian’s project and issue tracking platform, used by engineering, product, and ops teams to manage bugs, features, sprints, and roadmaps. Connecting Jira to Parabola lets ops, support, and program management teams pull issues, sprints, and project data into the same flows used for support tickets, customer data, and reporting, without manual exports or custom scripts.Documentation Index
Fetch the complete documentation index at: https://parabola.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Pull from Jira
The Pull from Jira step retrieves issues, projects, users, and field metadata from your Jira Cloud instance. Use JQL to filter precisely so you only pull what your flow needs.How to authenticate
Jira supports two auth methods. Most teams should start with Basic Auth using an Atlassian API token; OAuth 2.0 is available when stricter scoping is required.Option 1: Basic Auth with an API token (recommended)
Log in to your Atlassian account at https://id.atlassian.com/manage-profile/security.
Go to Security → API tokens and click Create API token. Give it a descriptive name and copy the token (you’ll only see it once).
Option 2: OAuth 2.0
Open the Atlassian Developer Console and create a new OAuth 2.0 integration (or pick an existing one).
Note the Client ID and Client Secret. Set the callback URL to
https://parabola.io/api/steps/generic_api/callback.Available data
The Pull from Jira step covers the endpoints most teams need for reporting. For anything not exposed natively, use a Pull from an API step pointed at the Jira REST API.- Issues — issue details: summary, description, status, priority, assignee, reporter, dates, custom fields, comments, attachments, and work logs.
- Issue search (JQL) — JQL-based queries against the issue index, with custom field selection and pagination. The most common Jira pull.
- Issue transitions — workflow transitions available for an issue, plus the screens and fields each transition requires.
- Projects — project metadata: name, key, lead, description, issue types, components, versions, and category.
- Project versions — release versions with dates, descriptions, archived/released flags, and issue counts by status.
- Users — display names, emails (subject to privacy settings), account IDs, active flag, and avatar URLs.
- Fields — system and custom field schemas with allowed values.
- Sprints and boards — agile board metadata and sprint contents (via Pull from an API against the Agile API).
Common use cases
- Sprint and release reporting: Pull issues filtered by sprint or fix version, calculate completion rates and velocity, and drop the result into Google Drive, Smartsheet, or a Slack summary for the standup.
- Tie support tickets to engineering work: Join Jira issues with tickets from Zendesk, Front, or Gorgias on a custom field to track which customer issues are blocked on engineering.
- Capacity and workload analysis: Pull issues and assignees, group by team and status, and surface bottlenecks before they hit standup. Pair with a CRM like HubSpot to weight by customer impact.
- SLA monitoring: Combine issue creation, status transitions, and resolution timestamps to track time-to-resolution against SLA targets and alert on breaches via Slack or Twilio SMS.
- Stale-ticket reminders: Query for issues open longer than N days with no recent activity and ping the assignee in Slack, or post a list to a project Asana board.
- Send Jira data to your warehouse: Push issue history into Snowflake, BigQuery, or Redshift for long-term velocity, defect-rate, and cycle-time analysis joined to the rest of the business.
Tips for using Parabola with Jira
- Use JQL to filter at the source. Filtering with JQL (
project = PROJ AND status = "In Progress" AND updated >= -7d) is faster than pulling all issues and filtering downstream, and it stays under Jira’s row limits. - Request only the fields you need. Set
fields=summary,status,assignee,updatedin the search query to keep payloads small. Pulling every custom field on a busy project gets slow fast. - Pull issues and users separately, then join. Issue payloads return assignees as account IDs. To get display names and emails, pull Users and join on
accountId. Same pattern for reporters and watchers. - Watch user privacy settings. Atlassian privacy controls can null out email addresses on the Users endpoint. If you need to map issues to email-based identities elsewhere, use a stable account ID as the join key.
- Match cadence to use case. Hourly for live ops dashboards and stale-ticket reminders, daily for sprint and SLA reporting, weekly for velocity and trend analysis.
- Handle pagination. The Jira search API returns 50–100 issues per page by default. Parabola handles pagination, but very large queries can hit rate limits — narrow the JQL or run the flow more frequently.
FAQ
Can I create or update Jira issues from Parabola?
Yes. Use a Send to an API step pointed at the Jira REST API (POST /rest/api/3/issue to create, PUT /rest/api/3/issue/{issueIdOrKey} to update) with the same Basic Auth credentials. Each row of data becomes one API call.
Does Parabola support Jira webhooks?
Yes, indirectly. Configure a Jira webhook (issue created, issue updated, issue transitioned) to point at a Parabola webhook trigger on a separate flow. The flow runs on each event.How do I pull sprint or board data?
Sprints and boards live on the Agile API (/rest/agile/1.0/). Use a Pull from an API step against /rest/agile/1.0/board and /rest/agile/1.0/sprint/{sprintId}/issue with the same credentials.
What’s the difference between issue search and the issues endpoint?
Issue search runs JQL and returns matching issues with paging and field filtering — that’s what most reporting flows use. The single-issue endpoint (/rest/api/3/issue/{key}) returns one issue’s full payload, useful when you already have the key and want every field.
Why do I see fewer issues than expected?
Two common causes: JQL filters are stricter than you think (try the same query in Jira’s search UI), or the user account behind your token doesn’t have permission to see those projects. Verify in Jira that the account can open the issues directly.With Jira and Parabola connected, the sprint reports, SLA dashboards, and ticket-to-issue reconciliations your team rebuilds every week run on a schedule with output landing in the systems where work actually happens.