Generic HMAC

Set up the webhook in Generic HMAC

1. Open the Generic HMAC webhook settings in the provider console.
2. Point the webhook at your Hooks endpoint URL (https://api.hooks.events/in/<endpoint-id>).
3. Paste the same secret into the endpoint so Hooks can check x-signature.

Signature verification

• HMAC-SHA256 over <timestamp>.<deliveryId>.<body>

Events Hooks normalizes

Normalized payload

Every adapter produces this shape before filters or templates run. The raw payload and sanitized headers stay attached for audit, but filters and templates read the normalized fields.

{
  "id": "evt_demo",
  "source": "generic",
  "type": "generic.received",
  "action": "received",
  "deliveryId": "delivery_demo",
  "subject": {
    "title": "Generic HMAC event"
  },
  "raw": {}
}

Filter and template examples

type equals "generic.received"

"Generic HMAC event: {{event.subject.title}}"

Retries and the delivery log

408, 425, 429, and 5xx responses retry with backoff and honor Retry-After; other 4xx responses fail permanently with a named code. Every attempt keeps the rendered request and the target response, so a failure points at one field or one status instead of a guess.

Common errors

Pair with a target

Reference

• Receiving eventshttps://hooks.events/docs/signatures.md
• Verify signatureshttps://hooks.events/docs/signatures.md
• Payload templateshttps://hooks.events/docs/templates.md

Other sources