Skip to main content

Jira Connection: Service Account Token (Cloud only)

In this article we are describing how to setup a connection to your Jira Cloud instance via the Service Account Token

Prerequisites

  • Jira Cloud (not Data-center)

  • Instance access, which allows to create a service accounts and their tokens

Step by step instructions

  1. On your Jira instance, go to Settings -> User management

  2. In the menu on the left navigate to Directory -> Service accounts

  3. Create a new service account

    1. Name: piplanning.io (something which identifies piplanning.io)

    2. App role: Jira with the Role "User"

    3. Groups: Will be automatically filled when you select the Role

  4. Select the service account (if not already)

  5. Click on "Create credentials"

    1. API Token

    2. Expires: Make it expire in a year, or according to your internal policies

    3. Search and then select (checkbox on the left) the following scopes:

      1. Read

        • read:jira-user

        • read:jira-work

        • read:board-scope:jira-software

        • read:board-scope.admin:jira-software

        • read:sprint:jira-software

        • read:project:jira

        • read:issue-details:jira

        • read:jql:jira

        • read:dev-info:jira

        Write

        • write:jira-work

        • write:board-scope:jira-software

        • write:sprint:jira-software

        Manage

        • manage:jira-project

    4. Copy the token

  6. In piplanning.io create/edit your Jira connection

    1. Select "Cloud Service Account Token"

    2. Paste your token into the API Token field

Did this answer your question?