How do I verify webhook signatures?

Updated Nov 2, 2026

With signing required, every event carries an HMAC-SHA256 signature of the exact request body.

Steps

  1. In the webhook settings, use an HTTPS URL that does not redirect and turn on Require HMAC-SHA256 signing.
  2. Click Generate key, then Copy key, and store it in your receiver before saving. Saved keys cannot be shown again.
  3. Click Save webhook.
  4. In your receiver, compute HMAC-SHA256 of the raw request body with the complete key (including whsec_) and compare the hex digest with the X-MailRush-Signature: sha256=… header using a constant-time comparison.
  5. Reject the request if they differ; process it only after verifying.

Good to know

  • Use the raw bytes as received, before JSON parsing.
  • How to verify signatures in the webhook settings shows a complete example.
  • When you replace a key, accept both the old and new keys while requests are in flight.
  • X-MailRush-Delivery-Id is for troubleshooting and is not covered by the signature.

More details in the FAQ

The FAQ is in the MailRush.io app under Support (sign-in required).

Related articles

Didn't find what you need?

Sign in to MailRush.io and open a support ticket, and our support team will get back to you.

Contact support