Git Integration for Jira Cloud Documentation

Contact support
GitKraken Status  

Adding webhooks for Azure DevOps Server | TFS

Pull request webhooks are now supported. See details on this page.

Supported webhook events:

  • Code pushed
  • Pull request created
  • Pull request updated
  • Pull request merge attempted

 

Right click here to open this video in a new browser tab for more viewing options. (While the above video showcases VSTS/Azure DevOps, the entire process is entirely the same for Azure Repos webhooks setup.)
Before you can proceed with the steps outlined on this guide, webhooks must be enabled in the Git Integration for Jira app repository configuration for your Jira instance. For more details, see Indexing triggers – Getting Started.

 

Configure webhook by logging in to your VSTS/Azure DevOps account:

  1. Open a project by clicking on it.


  2. On the sidebar, click Project Settings then select Service Hooks. The following screen is displayed.


  3. Click Create subscription to add a new service hook subscription.

  4. Scroll down to Web Hooks and click to select it.

  5. Click Next. The following screen is displayed.


    a. Set “code pushed” for the Trigger on this type of event selector.

    b. Set all FILTERS to Any.

    c. Click Next to proceed to the following screen.


  6. Switch to your Jira Cloud instance and navigate to Apps ➜ Git Integration: Manage integrations then click Indexing triggers on the sidebar.


  7. Copy the complete webhook URL by clicking the copy icon on the right (4).

  8. Switch back to Azure DevOps Server/TFS portal (where you left off):


    a. Paste the webhook URL into the Settings URL field.

    b. For the HTTP header, enter X-GIJ-Microsoft-Event:1. This header will improve webhook processing efficiency since we are only expecting specific MS events.

    c. Set Resource details to send to All.

    d. Set Messages to send to None.

    e. Set Detailed messages to send to None.

    The settings 8.d and 8.e limits the data transfered to your Jira instance since too much webhook traffic can degrade Jira performance.

  9. Click Test to verify if webhook integration is successful or not.


  10. Click Finish to complete this setup.

  11. Repeat the above steps for Pull request created and Pull request updated webhooks.


 

Pull request webhooks

The Git Integration for Jira app supports pull request webhooks now.

You will need to have three (3) separate service hooks configuration for it to work properly. Aside from setting up the “Code pushed” service hook outlined above in step 5.a, perform the same process with Pull request created and Pull request updated for the triggers.

Have feedback about this article? Did we miss something? Let us know!
On this page