Prerequisites
Jira Cloud (not Data-center)
Instance access, which allows to create a service accounts and their tokens
Step by step instructions
On your Jira instance, go to Settings -> User management
In the menu on the left navigate to Directory -> Service accounts
Create a new service account
Name: piplanning.io (something which identifies piplanning.io)
App role: Jira with the Role "User"
Groups: Will be automatically filled when you select the Role
Select the service account (if not already)
Click on "Create credentials"
API Token
Expires: Make it expire in a year, or according to your internal policies
Search and then select (checkbox on the left) the following scopes:
Platform API:
1. read:jira-user
2. read:jira-work
3. write:jira-work
4. manage:jira-projectAgile/Software API:
5. read:board-scope:jira-software
6. read:board-scope.admin:jira-software
7. write:board-scope:jira-software
8. read:sprint:jira-software
9. write:sprint:jira-software
10. read:project:jira
11. read:issue-details:jira
12. read:jql:jira
13. read:dev-info:jira
Copy the token
In piplanning.io create/edit your Jira connection
Select "Cloud Service Account Token"
Paste your token into the API Token field
