
What it does
Sends the events you subscribe to: sent, delivered, bounced, complaint, failed, opened, clicked, unsubscribed, campaign sent, contact updated, conversion recorded and store order events.
Signs every request with HMAC-SHA256 in the HyoNova-Signature header, so you can prove it came from HyoNova.
Retries a failed delivery up to 5 attempts in total (after about 1 minute, 5 minutes, 15 minutes and 1 hour).
Rotate secret signs with both the new and the old secret for 24 hours, so you can switch without losing events.
Who it is for
Developers who want email results and contact changes in their own CRM, data warehouse or app without polling.
How to connect it
Open Mail › Automations › Webhooks and choose New webhook.
Enter your HTTPS endpoint and tick the events you want.
Copy the webhook secret. It is shown once.
Verify each request's signature and answer with a 2xx status within 10 seconds.
What you need
An HTTPS endpoint on a public internet address.
Mail administration in HyoNova (Owners and admins by default). Webhooks are included in every plan.
Limits
These are Hyo Mail events. Other parts of HyoNova do not send webhooks to your systems.
Private, loopback and internal hosts are refused, and redirects are not followed.
A delivery can arrive more than once or out of order: use the delivery id to ignore duplicates.
After the fifth failed attempt, a delivery stops retrying; the Deliveries list shows its status and HTTP code.
Full guide: Webhooks reference