​

Webhooks Overview

Webhooks allow Mailofly to notify your application server in real-time when events occur — such as an email being delivered, opened, clicked, bounced, or flagged as a spam complaint.

---

​

How Webhooks Work

1. You register a public HTTPS endpoint in your Mailofly dashboard.
2. When an email event occurs, Mailofly sends an HTTP POST request with a JSON payload to your endpoint.
3. Your server validates the HMAC signature and processes the event (e.g. updating a customer’s record or notifying an account manager).

---

​

Setting Up a Webhook

1. In the sidebar, navigate to Settings → Webhooks.
2. Click Add Webhook.
3. Enter your Endpoint URL (must be https://).
4. Select the event types to listen for (e.g. email.delivered, email.bounced).
5. Copy the generated Signing Secret (whsec_...) to verify payloads.

---

​

Next Steps

• Supported Event Types & Payloads
• Verifying Webhook Signatures
• Retries, Timeouts, and Debugging