Documentation

Complete guide to webhooks, debugging, and real-time event monitoring with HookMetry

Common Webhook Errors

SIGNATURE_MISMATCH

Webhook signature doesn't match expected value

Causes:

  • Incorrect secret key
  • Payload modified in transit
  • Wrong validation type selected

Solutions:

  • Verify secret key from provider dashboard
  • Check for middleware modifying request body
  • Ensure validation type matches provider (Stripe/GitHub/HMAC)

MISSING_SIGNATURE

Required signature header not found in request

Causes:

  • Provider not sending signature header
  • Webhook not configured with secret
  • Proxy stripping headers

Solutions:

  • Verify webhook is configured with signing secret in provider
  • Check proxy/CDN isn't removing headers
  • Use validation type "None" for testing if signature isn't needed

QUOTA_EXCEEDED

Daily webhook quota limit reached

Current Limits:

  • Free Plan: 50 requests/day
  • Pro Plan: Unlimited
  • Team Plan: Unlimited

Solutions:

  • Upgrade to Pro plan for unlimited webhooks
  • Wait for quota reset (midnight UTC)
  • Review webhook frequency from provider

INVALID_JSON

Webhook payload is not valid JSON

Causes:

  • Provider sending malformed JSON
  • Content-Type mismatch (form data vs JSON)
  • Encoding issues

Solutions:

  • Verify Content-Type header is application/json
  • Check provider webhook format settings
  • View raw payload in logs to identify syntax errors