---
title: "Deploy Webhooks"
description: "Simple webhook client and server demo apps."
category: "Starters"
url: https://railway.com/deploy/WJuLbj
---

# Deploy Webhooks

Simple webhook client and server demo apps.

**[Deploy Webhooks on Railway](https://railway.com/template/WJuLbj)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/WJuLbj/manifest.json

- **Creator:** alphasec
- **Category:** Starters
- **Total deploys:** 202

## Template content

### webhook-server

- **Source:** alphasecio/webhook-client-server
- **Public domain:** Yes

### webhook-client

- **Source:** alphasecio/webhook-client-server
- **Start command:** `streamlit run app.py`
- **Public domain:** Yes

## Documentation

# Deploy and Host Webhooks on Railway

A minimal but realistic webhook client-server demo. The server receives signed webhook payloads and verifies them using HMAC-SHA256. The client provides a Streamlit UI to send signed or unsigned requests to any webhook endpoint — a practical introduction to the full webhook security pattern.

## About Hosting Webhooks

This Railway template deploys two services: a Node.js/Express webhook server and a Streamlit webhook client. The server exposes a parameterised `/webhook/:event` endpoint that accepts any event name, optionally verifies an HMAC-SHA256 signature against a shared secret, logs the event type and payload, and returns the received data as JSON. The client sends HTTP POST requests with a configurable URL, event type, JSON payload, and optional shared secret — if a secret is provided, the payload is signed automatically before sending. Both services are pre-configured to communicate over Railway's private internal network.

## Common Use Cases

- **Learning the webhook security pattern** — understand how HMAC-SHA256 payload signing works end-to-end, with a client that signs requests and a server that verifies them using a shared secret, mirroring how real providers like GitHub, Stripe, and Twilio secure webhooks
- **Testing and debugging webhook integrations** — use the client as a lightweight alternative to curl or Postman for sending structured JSON payloads with custom headers and signatures to any webhook endpoint, including third-party services
- **Starting point for custom webhook infrastructure** — extend the parameterised server route to handle specific event types, add persistence, queue processing, or notification logic on top of a working, security-aware foundation

## Dependencies for Webhooks Hosting

- Node.js webhook server — built from the `server/` directory; no external dependencies beyond Express
- Streamlit webhook client — built from the `client/` directory; communicates with the server over Railway's internal network at `webhook-server.railway.internal`
- No database or persistent volume required

### Deployment Dependencies

- [webhook-client-server GitHub repository](https://github.com/alphasecio/webhook-client-server)
- [Getting Started with Webhooks: Part 1 — Webhook Servers](https://alphasec.io/getting-started-with-webhooks-part-1-webhook-servers/)
- [Getting Started with Webhooks: Part 2 — Webhook Clients](https://alphasec.io/getting-started-with-webhooks-part-2-webhook-clients/)

### Implementation Details 

**Server endpoints:**
 
| Method | Path | Description |
|---|---|---|
| `GET` | `/` | Server info and available endpoints |
| `GET` | `/health` | Health check — returns `{ "status": "ok" }` |
| `POST` | `/webhook/:event` | Receives webhook for any event name |
 
**Signature verification** — set `WEBHOOK_SECRET` on the server service to enable HMAC-SHA256 verification. The server expects:
 
```
X-Webhook-Signature: sha256=
```
 
Requests with a missing or invalid signature return `401 Unauthorized`. If `WEBHOOK_SECRET` is not set, all requests are accepted — useful for open testing.
 
**Enabling signatures end-to-end:**
1. Set `WEBHOOK_SECRET` on the server service to a strong random string
2. Enter the same value in the client's **Webhook Secret** field before sending
3. The client signs the payload automatically; the server verifies it on receipt

## Why Deploy Webhooks on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Webhooks on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

## Similar templates

- [Openfront Gym](https://railway.com/deploy/openfront-gym) — Opensource Mindbody alternative based on Next.js and Keystone.js
- [open-excalidraw](https://railway.com/deploy/open-excalidraw) — Self-hostable collaborative drawing built on Excalidraw
- [Next.js + Prisma + PostgreSQL Starter](https://railway.com/deploy/nextjs-prisma-postgres) — Deploy a Next.js app with Prisma ORM and PostgreSQL in one click.

Open this page in a browser: https://railway.com/deploy/WJuLbj
