Honest defaults
Herald sends through SendGrid, believes only signed events, tracks nobody until you say so, and writes down every change.
Delivery and bounces
Mail leaves through the SendGrid v3 API from a rate-limited worker. SendGrid reports deliveries, bounces, spam complaints, opens, and clicks back to Herald, which checks each webhook's HMAC-SHA256 signature before it changes anything.
A bounce or a complaint changes the reader's status, so they are not mailed again, and each event lands in the audit trail.
Tracking is off until you turn it on
A new list does not track opens or clicks. Turn tracking on in the list's Settings and Herald adds an open pixel and routes links through a click redirect, which is what feeds the open and click rates.
The unsubscribe link is never rewritten for tracking.
The audit trail
Every change in Herald is saved as a record before it is announced: who did it, what it was about, and when. The list's name is saved with it, so deleting a list does not erase its history. Unattended work is credited to public, webhook, or system, never guessed. The Activity page filters the record by type and person, and live events slide in on top.
Webhooks, keys, and settings
Outbound webhooks fire on subscriber and email events, and each endpoint picks the events it wants or all of them. Each endpoint has its own signing secret, and each delivery carries an HMAC signature the receiver can check.
API keys belong to one list, are stored as SHA-256 hashes, and are shown in full only when created. A key reaches exactly the list it was made for.
Public endpoints
Signup forms, confirmation links, unsubscribe links, the archive, and the tracking pixel need no sign-in, so they are the part to guard.
- The endpoints that write, such as subscribe, the signup form, contact, and resend, are limited per address and endpoint, 10 a minute by default.
- A hidden honeypot field catches bots without a CAPTCHA.
- The client address comes from the proxy chain Herald is told to trust, never from a header the client wrote.
- A list's Settings page offers a copy-and-paste signup form that posts to the public form endpoint, with a hidden honeypot field.
- A signup form on a static site can post through the small signup Lambda.
Questions about this tool?
Write to Renkara Media Group and a person will answer.





