Mock Webhook Endpoint

What is a Mock Webhook Endpoint?

A mock webhook endpoint is a temporary, publicly accessible URL that acts as a stand-in for your production webhook handler. It accepts any HTTP request (GET, POST, PUT, PATCH, DELETE), logs the full request details, and returns a configurable response.

Mock endpoints are essential during the early stages of integration development. Before you write a single line of handler code, you can use a mock endpoint to discover the exact payload structure your webhook provider sends. This "payload-first" development approach saves hours of guesswork and documentation diving.

Unlike deploying a real server with a framework like Express, Flask, or Rails just to receive a test webhook, a mock endpoint is ready instantly. No code, no deployment, no DNS configuration. Just a URL that captures everything.

Why Use a Mock Webhook Endpoint?

The most immediate use is payload discovery: documentation is often incomplete or outdated, and a mock endpoint shows you the exact fields the provider actually sends. Build your database schema, validation logic, and handler code against real data rather than guesswork.

Captured payloads make good test fixtures. Copy the JSON from a real event, save it as a file, and replay it in your CI pipeline with cURL. Your unit tests run against the exact format the provider sends, not a hand-crafted approximation. When the provider changes their payload format, your tests will catch it.

For debugging: temporarily redirect production webhooks to a mock endpoint to inspect payloads when your handler is returning errors. See exactly what the provider is sending before your handler processes it.

How to Create a Mock Endpoint

Quick Test with cURL

You can also test your mock endpoint directly with cURL:

# Send a POST request to your mock endpoint
curl -X POST https://api.requex.me/hook/your-unique-id \
  -H "Content-Type: application/json" \
  -d '{"event":"order.created","order_id":"12345","amount":99.99}'

# Send a PUT request
curl -X PUT https://api.requex.me/hook/your-unique-id \
  -H "Content-Type: application/json" \
  -d '{"status":"updated"}'

# Send with custom headers
curl -X POST https://api.requex.me/hook/your-unique-id \
  -H "Content-Type: application/json" \
  -H "X-Custom-Header: my-value" \
  -H "Authorization: Bearer test-token" \
  -d '{"test": true}'

Mock Endpoint vs Real Server