Adding a GitHub Webhook in Your Jenkins Pipeline

DZone 's Guide to

Adding a GitHub Webhook in Your Jenkins Pipeline

Learn how to add GitHub webhooks to Jenkins pipelines to trigger the build when a developer commits code to the master branch.

· DevOps Zone ·
Free Resource

Have you ever tried adding GitHub webhook in Jenkins? In this blog, I will be demonstrating the easiest way to add a webhook in your pipeline.

First, what is a webhook? The concept of a webhook is simple. A webhook is an HTTP callback, an HTTP POST that occurs when something happens through a simple event-notification via HTTP POST.

GitHub webhooks in Jenkins are used to trigger the build whenever a developer commits something to the master branch.

Let’s see how to add build a webhook in GitHub and then add this webhook in Jenkins.

  1. Go to your project repository.
  2. Go to "settings" in the right corner.
  3. Click on "webhooks."
  4. Click "Add webhooks."
  5. Write the Payload URL as



Here, Payload URL is the URL where our Jenkins is running add github-webhook to tell GitHub that it is a webhook.

  • Content type: What kind of data we want in our webhook. I have selected JSON data.
  • Secret: Used to secure our webhook we can provide a secret in our webhook and ensure that only applications having this webhooks can use it.
  • SSL verification: This SSL Checker will help you diagnose problems with your SSL certificate installation. You can verify the SSL certificate on your web server to make sure it is correctly installed, valid, trusted and doesn’t give any errors to any of your users.

Which events would you like to trigger this webhook?

  1. Just the push event: Only send data when someone pushed into my repository.
  2. Send me everything: If there is any pull or push event in our repository we will get notified.
  3. Let me select individual events: We can configure for what events we want our data.

Click Create and a webhook will be created.


Here https://228b9f82.ngrok.io/ is the port or IP where my Jenkins is running.

Here is a problem you have to take care of if you are running Jenkins on localhost then writing https://localhost:8080/github-webhook/ will not work because Webhooks can only work when they are exposed to the internet.

So if you want to make your  localhost:8080 expose to the internet then we can use tool

Write GitHub-webhook to the ngrok tool refer to this link.

Now let’s see how to use this webhook in Jenkins.

  1. Go to Manage Jenkins -> Configure System
  2. Scroll down and you will find the GitHub Pull Requests checkbox. In the Published Jenkins URL, add the repository link
  3. Click on "Save."

Jenkins pipeline

Now go to the Jenkins pipeline and select "GitHub hook trigger for GITScm polling."

Jenkins pipeline

In this way, we can add a webhook to our job and ensure that everytime a developer commits a code to GitHub, our build will be triggered.

I hope this blog was helpful in adding GitHub webhooks in Jenkins.

ci/cd, continuous integration, devops, git, jenkins, tutorial, webhooks

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}