Git Integration for Jira Self-Managed (Data Center/Server) 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 and view this video in a new browser tab. (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 Webhooks – Getting Started.

Configure webhook by logging in to your Azure DevOps Server/TFS 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 instance then navigate to GitManage repositories page and then open Webhooks.


  7. Copy the complete Webhook URL by clicking the copy icon adjacent to the right of the URL field.

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


    a. Paste the webhook URL into the 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.

 

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.


 

More related articles about webhooks setup

Creating reindex triggers for a single repository

Adding webhooks for GitHub

Adding webhooks for GitLab

Webhooks GitHub Organization support

Adding webhooks for Azure DevOps Repos | VSTS

Adding webhooks for Azure DevOps Server | TFS (this page)

Adding webhooks for Bitbucket

Adding webhooks for Gerrit

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