Home API Tools Posts Hire Me About
Sign In Create Account
Live Free tier included

Webhook Relay & Queue API

Create relay endpoints that receive, log, and fan-out webhooks to multiple destinations. Full request logging, delivery tracking, and instant replay for debugging.

Try it Free View Docs
Fan-out to 10 URLs Request Logging Delivery Tracking Any HTTP Method
Interactive Playground

Try it Free

Create a relay endpoint and start forwarding webhooks in seconds.

Create Relay
Relay Stats

Enter a Relay ID to view stats and logs

API Documentation

Create relay endpoints that receive webhooks and fan them out to multiple destinations. Full request logging, delivery tracking, and replay support.

Endpoints

POSThttps://www.mahmoudalhabash.com/api/v1/relay/create

Create a new webhook relay.

GEThttps://www.mahmoudalhabash.com/api/v1/relay/{relay_id}/stats

Get relay statistics and recent logs.

ANYhttps://www.mahmoudalhabash.com/webhook/{relay_id}

Ingestion endpoint — send your webhooks here. Supports any HTTP method.

Create Relay Parameters

ParameterTypeRequiredDescription
namestringoptionalHuman-readable name for the relay
sourcestringoptionalSource label (stripe, github, shopify, custom)
destinationsarrayrequiredArray of destination URLs (1–10)

Response Fields

relay_id Unique relay identifier (e.g. rel_abc123)
ingestion_url URL to send webhooks to
destinations Array of destination URLs
total_received Total webhooks received
total_forwarded Total successful forwards
recent_logs Last 10 webhook events with delivery results

Code Examples

cURL — Create Relay
curl -X POST https://www.mahmoudalhabash.com/api/v1/relay/create \ -H "Content-Type: application/json" \ -d '{ "name": "Stripe Payments", "source": "stripe", "destinations": [ "https://myapp.com/webhook", "https://backup.com/hook" ] }'
Response 200JSON
{ "status": "success", "relay_id": "rel_abc123xyz", "name": "Stripe Payments", "ingestion_url": "https://www.mahmoudalhabash.com/webhook/rel_abc123xyz", "destinations": [ "https://myapp.com/webhook", "https://backup.com/hook" ], "active": true }

Error Codes

422 Validation failed — at least one valid destination URL required
404 Relay not found or inactive
500 Internal server error

Rate Limits

Unlimited — Free during beta

No API key required. Max 10 destinations per relay. Webhook payloads are stored for 30 days. Forwarding timeout is 10 seconds per destination.