GitHub Webhook with C#

March 06 2023


A Webhook is a mechanism that allows a web application to send real-time notifications or data to another web application.

It is essentially a way for two different applications to communicate with each other in "real time" rather than relying on periodic polling or manual data transfer.
An example of a simple implementation of a C# Webhook receiver for Github will be shown below.

**In this edition of the newsletter, there will be no mention of the implementation of the webhook mechanism (sender & receiver) due to the volume of the problem, which is not adequate for the newsletter.

C# Webhook receiver

A webhook receiver for an event that happened on Github or any other service can be represented in the simplest way as an HttpPost API endpoint in a C# controller.

• Create an action in C# Controller
You need to create C # API Controller with GitHubWebhookController name. This is a controller to serve for all Events that happen within Github repository.

After that, you need to add an endpoint Pushed for the "push" event on github, which will practically serve as a callback event.

GitHub Webhook Api Endpoint

This method must be HttpPost.
Since I currently don't know what the GitHub payload looks like, ie. object/JSON that GitHub sends during a specific event, I will state that the object that the method receives as a parameter is type dynamic.

​• Run the application

When you start the API project, through Swagger you can see Endpoint there is and that everything is fine for now.

Swagger GitHub Webhook Api Endpoint

Create Webhook instance on GitHub

GitHub Platform Adding Webhook

The most important field to fill in is of course the PayloadUrl.

This field represents the endpoint of our application that Github will call the moment a push event occurs on the selected repository.

Content type: You can choose application/json
Secret: You can generate via some online generator. This secret is used to verify that the payload was actually sent by Github and not by a malicious third party pretending to be Github. For demo purposes I will leave it blank, but do not do this on production.

GitHub doesn't know that your localhost exists somewhere on your computer. It is necessary that the application is deployed somewhere, say Azure.
But for testing and debugging, ngrok can help you.

What is ngrok?

Ngrok is a software tool that creates a secure tunnel between a local machine and the public internet, allowing developers to expose a web server running on their local machine to the internet.

Ngrok setup

• Download from: Ngrok
• Install it and run it
• Execute the following command: ngrok http port

*Port should be your port which you can see when you start the application
*You should disable https protocol for the application by replacing https urls with http in launchSettings.json.

Now you will see in CMD the url that is online and to which the localhost url is mapped.
If you visit the url from the 'forwarding' part, you will see exactly the same result as for localhost. Of course, the advantage of this is that the debugger is active.

Ngrok Console Running

The next thing is to put that ngrok url together with the API endpoint in the Payload Url field:

#1 Testing

1. Run the application
2. Put a breakpoint in the Pushed method
3. Go to the repository and make some changes

GitHub Commit Changes

3. Wait for a couple of seconds, and call should hit the debugger
4. You can see parameter payload is full of data

Webhook Endpoint Payload

What next?

On this very simple example, I have shown how a webhook receiver for Github can be implemented.

In this way, any service that supports WebHooks works. With the fact that there is a difference from service to service in the payload that is sent, so based on what you need, you will create a class with properties instead of receiving a dynamic type of payload.

Also, this can be implemented with Azure Functions, so be sure you do a research on that topic.

For GitHub payload for each webhook you can find at: Github Webhook Documentation

That's all from me for today.

Make a coffee and check out source code directly on my GitHub repository.

dream BIG!

Join 10,950+ subscribers to improve your .NET Knowledge.

There are 3 ways I can help you:

Design Patterns Simplified ebook

Go-to resource for understanding the core concepts of design patterns without the overwhelming complexity. In this concise and affordable ebook, I've distilled the essence of design patterns into an easy-to-digest format. It is a Beginner level. Check out it here.


Promote yourself to 10,950+ subscribers by sponsoring this newsletter.

Join .NET Pro Weekly Newsletter

Every Monday morning, I share 1 actionable tip on C#, .NET & Arcitecture topic, that you can use right away.

Subscribe to
.NET Pro Weekly

Subscribe to the .NET Pro Weekly and be among the 10,950+ subscribers gaining practical tips and resources to enhance your .NET expertise.