Corral Docs

Self-hosted webhook inbox. Capture, inspect, replay, and forward webhooks.

Overview

Self-hosted webhook inbox. Capture, inspect, replay, and forward webhooks. License: Apache 2.0. Default port: 8760.

Part of the Stockyard family of developer tools. See the product page →

Install

curl -fsSL https://stockyard.dev/corral/install.sh | sh

Or download a release binary from GitHub Releases.

Quickstart

# Install
curl -fsSL https://stockyard.dev/corral/install.sh | sh

# Run
DATA_DIR=./data corral

# Create endpoint
curl -s -X POST http://localhost:8760/api/endpoints \
  -H 'Content-Type: application/json' \
  -d '{"name":"my-webhook"}'

# Replay a captured event
curl -s -X POST http://localhost:8760/api/events/{event_id}/replay \
  -H 'Content-Type: application/json' \
  -d '{"target":"http://localhost:3000/webhook"}'

Environment Variables

Variable	Description	Default
PORT	HTTP listen port	8760
DATA_DIR	SQLite data directory	./data
RETENTION_DAYS	Auto-delete events older than N days	30

API Reference

POST/hook/{endpoint_id}

Ingest a webhook — use this as your capture URL

GET/api/endpoints

List all endpoints

POST/api/endpoints

Create an endpoint

GET/api/endpoints/{id}/events

List events for an endpoint

GET/api/events/{id}

Get full event detail (headers, body)

POST/api/events/{id}/replay

Replay event to a target URL

POST/api/endpoints/{id}/forwards

Create a forward rule

GET/api/endpoints/{id}/stream

SSE real-time stream

GET/health

Health check

Note — Admin endpoints require Authorization: Bearer <admin-key>. The admin key is set via the environment variable for this tool.

Deployment

Run the binary directly or use the provided Dockerfile. Set DATA_DIR to a persistent volume path. The binary is statically linked with no external dependencies.

docker build -t corral .
docker run -e FENCE_ADMIN_KEY=secret -v /data:/data -p 8760:8760 corral

When to use Stockyard instead

If you're building LLM-powered applications and need request tracing, cost tracking across 16 providers, model routing, prompt management, and team collaboration tools — Stockyard is the full platform. It includes capabilities from across the focused tools family in one binary.