Git Integration for Jira Self-Managed (Data Center/Server) Documentation

Contact Support: Server  
Contact Support: Data Center  

Adding Webhooks for GitHub

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

Supported webhook events:
  • Pushes event
  • Pull request events

Right click here to open this video in a new browser tab for more viewing options.

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 GitHub account:

  1. Select a repository.

  2. Go to the Settings page.

  3. On the sidebar under Code and information, click Webhooks.

  4. Click Add webhook. The following page is displayed:

    • Paste the obtained Secret URL from the Git Integration for Jira app ➜ Webhooks page into the Payload URL field.

  5. For the Content type, choose application/json. IMPORTANT

  6. Select the Just the push event option as triggering event. This is the default option when creating a new webhook.

  7. Click Add webhook to save the new webhook settings.

Pull request event webhook

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

You will need to enable two (2) event triggers in your GitHub webhooks configuration (Repo ➜ Settings ➜ Webhooks) for it to work properly. Under event triggers section, choose Let me select individual events and then select both "Pushes" and "Pull request" triggers instead as outlined above in step 6.

For the figure above:

  • Just the push event – This is the default configuration and this works only for commits.

  • Send me everything – This would send commits/pull requests events but is very verbose. We don’t recommend this configuration.

  • Let me select individual events (Pushes/Pull requests) – This would work better than the second option and we recommend this configuration.

Webhooks will be automatically registered for each GitHub repository connected to Jira Server to instantly index your commits. For this to work, the connecting GitHub user must be the Organization Owner or have repository ADMIN rights.

Webhooks will be deleted when GitHub integration is disconnected from Git Integration for Jira Server.

Git Integration for Jira will index only the updated repositories as indicated by the GitHub organization or GitLab group webhook.

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