Swarmhit's own: gateway.mail_complaint, a recipient reported a mail as spam (an ARF report).
Header Parameters
base64url(HMAC-SHA256(raw body, your webhook's signing secret)), the secret being the whsec_… shown in the console. Verify it over the raw bytes before parsing, and refuse the event when it does not match.
The event id, also event_id in the body: the same on every retry of the event. Deduplicate on it.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
Example Requests
/EmailComplaintEmail: mail bounced Webhook
Swarmhit's own: `gateway.mail_bounced`, a delivery report for a mail sent from the mailbox. `action: failed` is final, `delayed` a warning. `response` carries the server's status and words; classifying them is yours.
Email: mail failed Webhook
Swarmhit's own: `gateway.mail_failed`, the engine gave up sending a queued mail after its retries.