Automated Integrations
      Back to home
      2. Automated Integrations

      How do I set up my Jira integration

      This help article outlines the steps required to connect Adoptech to Jira

      How do I configure Jira?

      Creating the API Key

      1. Go to Account settings
      2. Select the Security tab
      3. Scroll down to API Tokens and click on Create and manage API tokens
      4. Select the Create API token button
      5. Fill in the Name and expiry - Note: Jira limits the token to a max life of 1 year

      6. Once created you can then copy the API token. Note: you will need to save the token somewhere safe as it cannot be viewed again once you click Done 

      Setting up WebHooks

      WebHooks are required to enable the two way communication between Adoptech and Jira. If you create a ticket in Adoptech and send it to Jira, any updates (to supported fields) will also be updated in Adoptech. This allows the ticket to remain in sync between systems.

      You will need Admin permissions in Jira to set up WebHooks.

      1. Go to Jira admin settings/System

      2. Scroll down to Advanced/WebHooks

      3. Select Create a WebHook

        1. Give the WebHook a name

        2. Enter the following url (your VENDOR_ID can be found on the Company Profile page in Adoptech. If you cannot find this please ask Adoptech Support).

          https://portal.adoptech.co.uk/webhooks/jira_issue/VENDOR_ID
        3. Under Issue related events
          1. Enter the following syntax (select your Project )
            Project = "project_name" AND labels in (Adoptech)
          2. Select Issue types:       
             

      How do I configure Adoptech?

      Once you have generated the API token in Jira you can create the integration in Adoptech.

      1. Select Apps and Integrations page from the LHS menu
         
      2. Find the Jira tile and click On Connect
      3. The RHS menu
        1. Enter the API key generated above into the API Key field
        2. The domain can be found from your Jira url - vendor-jira.atlassian.net 
        1. Enter the email address of the user who owns the API Key - Note: this user will default to be the 'Reporter' of the task in Jira for all tasks raised via Adoptech.
        2. Then click on the orange Connect button

       

      Once your integration is configured you can start to create Tasks in Adoptech that will flow through to Jira.  This help article explains more about how to do this.