Feature Guide
Custom HTTP Responses
Simulate 200, 404, 500, and every status code in between — so your error handling is bulletproof before you ship to production.
Why It Matters
Test the failure paths your users will actually hit
Most webhook integrations work perfectly on the happy path. The bugs surface when a payment provider times out, a CRM returns 502, or a service abruptly switches to 401. WebhookWatch lets you configure exact HTTP responses so you can verify your retry logic, alert thresholds, and fallback flows in seconds.
Success Scenarios
Return a 200 OK with custom JSON payloads to validate your parsing logic. Set response headers like Content-Type: application/json and X-Request-Id to match real provider behavior.
Not Found & Client Errors
Simulate 400 Bad Request, 401 Unauthorized, 403 Forbidden, and 404 Not Found. Verify that your code logs the right error level, notifies the correct Slack channel, and does not silently swallow client-side failures.
Server Errors & Timeouts
Trigger 500 Internal Server Error, 502 Bad Gateway, and 503 Service Unavailable responses. Test your exponential backoff strategy, circuit breaker thresholds, and dead-letter queue routing under realistic failure conditions.
Configuration
Define your response in a few lines
Set status codes, headers, and body content through our dashboard or API. Each custom response is attached to a unique webhook URL that you share with your integration partner.
POST /api/v1/endpoints/:id/responses
Content-Type: application/json
{
"status_code": 502,
"headers": {
"Content-Type": "application/json",
"Retry-After": "30"
},
"body": {
"error": "bad_gateway",
"message": "The upstream payment processor is temporarily unavailable",
"request_id": "req_8f3a2b1c"
},
"delay_ms": 2500
}The example above configures endpoint whk-7d4e9f to respond with a 502 Bad Gateway after a 2.5-second delay — mimicking a slow-responding payment processor like Mollie or Adyen. Attach this response to a scheduled delivery and watch your error handler fire in real time.
Response presets used by our customers
WebhookWatch ships with 12 ready-made response templates based on real integrations from Stripe, Mollie, Salesforce, and ShipStation. Pick one, tweak the payload, and start testing immediately.
Instant Playback
Send a webhook to your custom endpoint and receive your configured response within 50ms. No queue, no batching — just direct request/response testing.
Scheduled Replays
Set up recurring deliveries every 5 minutes, hourly, or on a custom cron schedule. Perfect for load-testing your error handling pipeline during off-hours.
Request History
Every incoming request is logged with full headers, body, and timestamp. Correlate your custom responses with actual inbound payloads to debug mismatches.