Deploy webhook listeners.

What you can connect

Webhook listeners fit events sent by another system.

From handler to live endpoint

Keep the handler focused on the event. We provide the endpoint and the evidence around every request.

Just write your handler

Use the framework and request handling code that already fit your integration.

Node.js webhook

const express = require('express');
const app = express();
const port = process.env.PORT || 3000;
const secret = process.env.WEBHOOK_SECRET;

app.use(express.json());

app.post('/webhook', (req, res) => {
  if (!secret || req.get('x-webhook-secret') !== secret) {
    return res.sendStatus(401);
  }

  console.log('event received', req.body.type);
  res.sendStatus(204);
});

app.listen(port);

Python webhook

import os
from flask import Flask, request

app = Flask(__name__)

@app.post('/webhook')
def webhook():
    secret = os.getenv('WEBHOOK_SECRET')
    if not secret or request.headers.get('X-Webhook-Secret') != secret:
        return 'Unauthorized', 401

    event = (request.get_json(silent=True) or {}).get('type')
    print('event received', event)
    return '', 204

if __name__ == '__main__':
    port = int(os.getenv('PORT', '5000'))
    app.run(host='0.0.0.0', port=port)

Go webhook

package main

import (
    "log"
    "net/http"
    "os"
)

func webhook(w http.ResponseWriter, r *http.Request) {
    secret := os.Getenv("WEBHOOK_SECRET")
    if secret == "" || r.Header.Get("X-Webhook-Secret") != secret {
        http.Error(w, "unauthorized", http.StatusUnauthorized)
        return
    }

    log.Println("event received")
    w.WriteHeader(http.StatusNoContent)
}

func main() {
    port := os.Getenv("PORT")
    if port == "" {
        port = "8080"
    }

    http.HandleFunc("/webhook", webhook)
    log.Fatal(http.ListenAndServe(":"+port, nil))
}

What Tokay handles