Jira software


You can integrate your TeamRetro team with your Jira Software project, to automatically publish team action items as Jira issues. To configure this integration you must be a TeamRetro team administrator


Supported Jira editions:

  • Jira Software (Cloud)
  • Jira Software (Data Center)
  • Jira Software (Server)

Supported authentication methods:

  • Jira Cloud - Atlassian Login - connect to your Jira Software (Cloud) instance using the Atlassian Cloud Oauth2 provider.
  • Atlassian Cloud - API Token - connect to your Jira Software (Cloud) instance with a secure way of using scripts.
  • Jira Server / Data Center - Application Link - connect to your Jira Software (Data Center / Server) using your Jira instance as an Oauth provider.
  • Jira Server / Data Center - Basic Authentication - connect to your Jira Software (Data Center / Server) using username / password.
  • Jira Server / Data Center - Personal Access Token - connect  to your Jira Software (Data Center / Server) using personal access tokens as a safe alternative to authenticating with a username and password.

Please note if connecting to Data Center or Server editions, your Jira instance must be publicly accessible on the internet (so our application can talk to it). For further information how our Jira integration works please refer to Jira Software Integration Security

Configure in TeamRetro

  1. On the TEAM > SETTINGS > INTEGRATIONS screen

  2. Click CONNECT next to Jira Software


  3. In the configuration dialog, select the AUTHENTICATION METHOD you wish to use.
    1. Jira Cloud - Atlassian Login
    2. Jira Cloud - API Token
    3. Jira Server / Data Center - Application Link
    4. Jira Server / Data Center - Basic Authentication.
    5. Jira Server / Data Center - Personal Access Token


  4. If you selected Jira Cloud - Atlassian Login for Jira Software (Cloud):
    1. Click Sign In To Atlassian Cloud


    2. You will be redirected to atlassian.com to authorize TeamRetro to post and create issues in your Jira cloud.

      For further information how our Jira integrations work and the authorization scopes requested, please refer to Jira Software Integration Security

    3. Click on Accept to authorize TeamRetro.
    4. Select your Atlassian Cloud instance from the dropdown


    5. Click NEXT (->)

      If you selected Atlassian Cloud - API Token for Jira Software (Cloud), you first need to configure the API Token in your Jira instance. 

    6. Open your Jira instance in a new tab and navigate to Your profile and settings > Manage account
    7. You will be directed to Atlassian Account and select Security tab
    8. Click Create and manage API tokens
    9. Click Create API token

    10. In the Create API token dialog
      1. Enter Label: TeamRetro (or similar)
      2. Click Create

      3. On the new API token screen, make note of or copy your API token

    11. Return to the TeamRetro tab
    12. Enter your: Atlassian Cloud URL (note: your Jira instance must be accessible on the public internet to our IP addresses)
    13. Enter your: Email Address

      Enter your: API token (provided by Jira)

      Click Next (->)

  5. If you selected Jira Server / Data Center - Application Link for Jira Software (Data Center) or Jira Software (Server), you first need to configure the Application Link in your Jira instance.
      1. Open your Jira instance in a new tab and navigate to Settings > Applications
      2. Select Application Links under Integration on the left side
      3. Click Create Link
      4. In the Create Link dialog
        1. Select External Application
        2. Select Incoming
        3. Press Continue


        4. On the Configure an incoming link page:
          1. Enter Name: TeamRetro (or similar)
          2. Enter Redirect URL:

            https://oauth.teamretro.com/integrations/jira/applicationLink (for US environment)

            https://oauth.eu.teamretro.com/integrations/jira/applicationLink (for EU environment)

          3. Select Permission: Write
          4. Click Save

        5. On the Credentials screen, make note of your Client ID and Client secret


      5. Return to the TeamRetro tab
        1. Enter your: Jira URL (note: your Jira instance must be accessible on the public internet to our IP addresses)
        2. Enter your Client ID (provided by Jira)
        3. Enter your Client Secret (provided by Jira)
        4. Click Next (->)


      6. Click Sign In To Jira


      7. Your Jira instance will prompt you to authorize TeamRetro for access, click Allow

  6. If you selected Jira Server / Data Center - Basic Authentication for Jira Software (Data Center) or Jira Software (Server):
    1. Enter your:
      1. Jira URL (note: your Jira instance must be accessible on the public internet to our IP addresses)
      2. Jira Username (we recommend creating a new user with minimal permissions for this)
      3. Jira Password

      4. Click NEXT (->)


        If you selected Jira Server / Data Center - Personal Access Token for Jira Software (Data Center) or Jira Software (Server), you first need to configure the Application Link in your Jira instance.

    2. Open your Jira instance in a new tab and navigate to Your profile picture > Profile > Personal Access Token
    3. Click Create Token
    4. In the Create a personal access token dialog
      1. Enter Name: TeamRetro (or similar)
      2. Select Expiry date (you can select Automatic expiry or Never expiry)
      3. Click Create

    • On the Credentials screen, make note of your Personal Access Token


    • Return to the TeamRetro tab.


    1. Enter your: Server URL (note: your Jira instance must be accessible on the public internet to our IP addresses)
    2. Enter your Personal Access Token  (provided by Jira)

    3. Click NEXT (->)
  7. On the PROJECT screen - choose the project that is associated with this TeamRetro team

  8. On the ISSUE TYPE screen - select the Jira Issue Type that should be created for each action item (eg. Task)

  9. On the FIELDS screen - you can customize additional fields to be sent to Jira, for example set a label to indicate the issue came from TeamRetro. 

    Please ensure all required fields in your Jira instance have a suitable value (otherwise publish will fail). 


  10. On the TEST screen - click "Publish Test Action Item To Jira" to confirm that your integration is set up correctly. If the new action item is published successfully, you will see a notification with the option to View in Jira or Delete. If an error is encountered (such as a missing required field) details will be displayed.

  11. Click SAVE CHANGES

Using Your Integration

Back on your  Team > Home screen, click the publish icon and you will see "Publish to Jira Software" as an option. After selecting, TeamRetro will create a new issue in Jira and display the Issue Number on the action item.

Individual action items can be published by Jira by clicking on the Jira icon on the right hand side and selecting "Publish to Jira Software"


Jira 2-Way Synchronization

When enabled, TeamRetro will periodically check the action items it’s published to your Jira instance. If the completion state, due date, assignment or priority has been updated,  these will be reflect back in TeamRetro.

  • Completion status - fully synchronized
  • Due date - fully synchronized
  • Assignment - best effort (user must exist in TeamRetro)
  • Priority - best effort (equivalent priority must exist in TeamRetro)

Only Jira issues originally created by TeamRetro will be polled and synchronized. 

Still need help? Contact Us Contact Us