A Express middleware for handle Github Webhooks
Last updated 5 years ago by gisonrg .
MIT · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install express-github-webhook 
SYNC missed versions from official npm registry.


Build Status

A Express middleware for handle Github Webhooks

To Install:

npm install express-github-webhook

To Use:

Make sure you use body-parser middleware for your Express app

var GithubWebHook = require('express-github-webhook');
var webhookHandler = GithubWebHook({ path: '/webhook', secret: 'secret' });

// use in your express app
let app = express();
app.use(bodyParser.json()); // must use bodyParser in express
app.use(webhookHandler); // use our middleware

// Now could handle following events
webhookHandler.on('*', function (event, repo, data) {

webhookHandler.on('event', function (repo, data) {

webhookHandler.on('reponame', function (event, data) {

webhookHandler.on('error', function (err, req, res) {

Where 'event' is the event name to listen to (sent by GitHub, such as 'push'), 'reponame' is the name of your repo.

'error' event is a special event, which will be triggered when something goes wrong in the handler (like failed to verify the signature).

Available options for creating handler are:

  • path: the path for the GitHub callback, only request that matches this path will be handled by the middleware.
  • secret (option): the secret used to verify the signature of the hook. If secret is set, then request without signature will fail the handler. If secret is not set, then the signature of the request (if any) will be ignored. Read more


  • Add support for content type of application/x-www-form-urlencoded
  • Provide more available options
  • Get rid of body-parser middleware



Current Tags

  • 1.0.6                                ...           latest (4 years ago)

5 Versions

  • 1.0.6                                ...           4 years ago
  • 1.0.5                                ...           5 years ago
  • 1.0.4                                ...           5 years ago
  • 1.0.3                                ...           5 years ago
  • 1.0.1                                ...           5 years ago
Maintainers (1)
Today 0
This Week 0
This Month 5
Last Day 0
Last Week 0
Last Month 3
Dependencies (1)
Dev Dependencies (5)

Copyright 2014 - 2016 © |