Jira permissions are complex, and your instance may have different permissions setups depending on the product and version. Learn more about the API endpoints Flow uses to collect information from Jira to check which other permissions you may need.
Note: By default, on the integration details page and the Ticket projects page, the last updated date is set from the timezone from the Jira user profile of the service account or user who set up the integration. If Flow does not have access to the /rest/api/2/myself endpoint, this time will be listed in UTC.
Version Requirements
Jira version 7.13 or higher
Flow integrates with Jira Cloud, Jira Data Center, and Jira Server. Project data is available from Jira Software and Jira Work Management products. While projects from Jira Service Management will appear on the Ticket projects page, they can't be processed by Flow.
In the left navigation under Integrations, click Integrations.
Click the Add integration button in the top right corner of the Integrations page.
Click Jira Cloud & Self-Managed on the Integration Provider page.
Choose one of three ways to connect your Jira instance:
OAuth establishes a connection to Flow via an application link:
Note: Flow can only connect via OAuth version 1.0a.
Access Token establishes a connection to Flow via an access token.
Username/password establishes a connection to Flow with your Jira credentials. We strongly suggest you connect to Jira via OAuth or Access Token.
Important: If you migrate your Jira instance from Jira self-hosted to Jira Cloud, you must create a new integration. Updating your Base URL for your existing integration doesn't update your connection and Flow can't ingest data.
Sometimes browser add-ons can interfere with this connection. If you plan to connect your Jira account via OAuth, we recommend opening Flow in an Incognito window to set up this integration. Flow can only connect using OAuth version 1.0a.
Paste your Jira account's base URL into the Base URL field. It looks something like: https://[your company].atlassian.net.
Click Get Keypair.
If the test is successful, you will be provided the credentials you need for your application link in Jira.
Click the Open button under the first step. This takes you to the page in Jira you need for the next steps. If you're prompted to log in, do so with administration credentials. Learn more about using AppLinks in Jira (external site, opens in new tab).
Copy and paste the following URL into the field under Configure Application Links: https://jira.flow.pluralsight.com. If prompted, select the Application type as Atlassian product to ensure you're using OAuth version 1.0a. Learn more about linking to other applications in Jira (external site, opens in new tab).
An advisory box appears. Confirm the URL is accurate.
Click Continue.
In Jira, enter GitPrime into the Application Name box.
Application type defaults to Generic Application. Leave it as Generic Application.
Do not populate any other fields.
Click Continue.
This takes you to another modal in Jira. Enter the Consumer Key, Consumer Name, and Public Key provided by Flow.
Click Continue. This establishes the application link in Jira. You'll see the application link added to the list.
Note: All of this information can be found on the modal you've been using to connect Flow to Jira.
Important: Before proceeding to the next step, make sure you have pop-ups disabled on your browser. The following steps will include a pop-up that will finalize your connection to your Jira account. If you have pop-ups blocked, you'll have to start all over.
Back in Flow, click Test Connection.
On the Jira authorization page, click Allow. This establishes the connection on the Flow side to Jira. After this is done, the page will show success.
Click Next. Then proceed to the Final steps section of this article.
Select the services you want to integrate from Jira. The only option here is tickets. Leave that status toggle set to on. If you disable tickets, Flow doesn't show any data from Jira.
Click Next.
Enter the name you want to give the Jira integration.
Click Create.
A Successfully Created banner displays once the connection is established.
Toggle the Import button to on for each project to import the projects you want to track in Flow. By default, importing for all projects is set to off.
In addition to importing your projects, you can also perform the following actions on this integration:
Auto Import all projects - Turning this on auto imports all projects and continues to import new projects if applicable.
Pause all imports - This keeps new data from being imported. This does not remove existing data.
Refresh - This refreshes all ticket projects and discovers any new projects not already displayed in your Project list.
Settings - Click Settings to pause or turn off ticket ingestion. Toggle Ticket Services to off to remove all data associated with this Integration. Pausing this service will pause ingestion of new data.
If you receive an error message when testing your connection during the setup process, check the following and try again:
Confirm that your base URL is correct.
Confirm that your permissions are correct.
OAuth authentication method:
Ensure that all fields are left blank except Application name.
Confirm that you checked the box next to Create incoming link.
Access token authentication method:
Confirm that you pasted your access token without additional characters or spaces before or after the token.
Confirm the email address you provided is the same email address associated with your Jira account.
Confirm that you're connecting to Jira Cloud, not Jira Data Center or Jira Server. If you need to connect to Jira Data Center or Jira Server, use an alternate authentication method.
