Newsletters for more than one list

Your message, delivered.

Herald runs every newsletter you publish from one place, with a separate audience, template set, and settings for each list.

Illustration: an old post-office sorting hall, a single cream envelope standing beside a brass bell on a wooden counter under a magenta lantern.
The film · 1:15

Write once. Test a little. Send once.

Three lists that differ, a reader who counts only after the click, a preview with its size, a subject-line test on a slice, a winner by open rate, a Send that mails each reader once, and tracking that stays off until you turn it on, all on StrataForge Robotics’ fictional lists.

Music and on-screen text, no narration; the captions describe the music and sound. Herald’s own screens with fictional StrataForge Robotics data, from the real web app running on one Mac that cannot send mail: Subscribers, the composer, Emails, and a list’s settings. The drawings are labeled as illustrations.
Read the film’s text version

Title: Herald. Your message, delivered. 2026. A bright, energized electronic score runs under the whole film, with a soft tick or hit on each action.

The hook: “One tool. Many lists.” Three list cards, drawn from the app’s own records and labeled as an illustration: Product release notes, BioMedical stories, and Investor update. Each has its own sender, its own rules (double opt-in or none, tracking on or off), and its own readers. Seven marks follow, one per list.

Consent: As the beat drops: “A link, first.” A drawn confirmation mail with a Confirm button and a 64-character one-time token. “Counts after the click.” The real Subscribers page, filtered to Unconfirmed, with the filter and the first reader’s chip ringed, and twenty-four amber marks, one for each unconfirmed reader of Product release notes, beside 2,036 active. One mark turns green, drawn, the line reads 23 unconfirmed and 2,037 active, and a second line says only active readers get mail.

Compose: “Write it once.” The real composer, with the template picker and the preview’s size, 7.1 KB, ringed. “Warned before Gmail clips.” A drawn meter shows 7.1 KB against the 102,000 bytes past which Herald warns. “Send yourself a test.” The composer’s Send test button is ringed; nothing is sent.

Test: “Test a slice first.” The composer’s A/B test button is ringed. “Three subject lines.” A drawn list bar splits into a 20 percent test slice of 300 readers and 1,200 who wait, and the sample test’s three real subject lines arrive, 100 sends each: the control, “Release notes: clinic updates, August,” and two others.

Winner: As the beat drops again: “Open rate picks the winner.” Three bars rise from the sample test’s own results, 31, 38, and 34 percent, and the second is checked, with a note that a challenger needs at least 1.05 times the control’s rate or the control wins. “The rest get the winner.” A drawn bar fills with the winning line for the 1,200 who waited. “It stays on the record.” The real Emails page, with “Winner: B (38.0% open rate)” ringed.

Once: “Send once.” Two drawn Send buttons are clicked at the same instant. One is claimed and sending; the other is refused in the app’s own words, “This email is already being sent.” A line reads 1,500 readers, one email each.

Honest defaults: “Tracking is off until you say so.” The real settings page of a list with tracking off, the Open/click tracking row ringed between Double opt-in and Public archive, which are on. “Unsubscribe in one click.” A drawn mail app shows its own Unsubscribe button and the one-click unsubscribe header, labeled RFC 8058.

Close: “Write once. Test a little.” “Send once.” Two hits, one for each line.

End card: The mark, Herald, the tagline, “Your message, delivered.”, and fleet@renkara.com, on the final chord.

Features

A newsletter platform you can read in an afternoon

Herald does the unglamorous parts well: it keeps lists apart, only mails people who said yes, puts the unsubscribe link where the law and good manners want it, and lets you test a subject line before the whole list sees it. An agent server with 63 tools reaches all of it.

Lists, readers, and consent

Many lists, kept apart

Each list has its own subscribers, tags, segments, templates, API keys, webhooks, and settings. The top bar picks one list or shows All Lists, which is the default, and a row always acts on its own list.

Herald's dashboard across all of the fictional StrataForge Robotics newsletters: tiles for new signups, unsubscribes, active subscribers, emails sent, open rate, and click rate, charts of signups and engagement per day over 30 days, signups by list, and a table of recent signups.Herald's dashboard across all of the fictional StrataForge Robotics newsletters: tiles for new signups, unsubscribes, active subscribers, emails sent, open rate, and click rate, charts of signups and engagement per day over 30 days, signups by list, and a table of recent signups.
The dashboard: every list at once by default, with signups and engagement over 7, 30, or 90 days. Enlarge to see the full screen.

Double opt-in

A new signup gets a confirmation email with a 64-character random link and counts only after the click. An expired link offers a fresh one, and a list can turn double opt-in off.

Herald's Dashboard for Product release notes after a reader confirms: the Signups by list row reads 36 new, 2,037 active, and the first row of Recent signups, dated Oct 21, 3:39 PM, shows an Active chip.Herald's Dashboard for Product release notes after a reader confirms: the Signups by list row reads 36 new, 2,037 active, and the first row of Recent signups, dated Oct 21, 3:39 PM, shows an Active chip.

Herald's Dashboard for the Product release notes list, in a phone-width window. The Signups by list row reads 36 new, 2,036 active, and the first row of Recent signups, dated Oct 21, 3:39 PM, has a gray Unconfirmed chip; a ring marks the count and the chip. Then the row reads 2,037 active and the same row's chip reads Active.

A reader counts only after the click.

Tags and segments

Tag readers by hand, by an automation step, or through the API. A segment gathers the active readers who carry any of its tags, and its preview, its count, and the send itself all use the same rule.

Import and export
Upload a CSV with an email column, or download a list's readers as CSV whenever you like. Addresses already on the list or on the suppression list are skipped.
One-click unsubscribe
Every email carries the List-Unsubscribe and List-Unsubscribe-Post headers (RFC 8058), so mail apps show their own unsubscribe button. Markdown emails also get a visible footer with an unsubscribe link and the list's mailing address.
Herald's Subscribers page listing readers across all lists with a checkbox, email, list, status, tags, and signup date, plus a search box and filters for status and tag.Herald's Subscribers page listing readers across all lists with a checkbox, email, list, status, tags, and signup date, plus a search box and filters for status and tag.
Subscribers: one table across every list, filtered by status or tag. Import and export wait for you to pick a list.

From a Markdown draft to an inbox

A composer with preview

Write in Markdown and see the email beside it as a reader will get it: Herald renders the Markdown into email HTML, or through an HTML template you pick. Save a draft, send a test, schedule it, or send it now.

Test sends
Send a draft to any address or to subscribers you search for. A test send records nothing against the campaign, so you can repeat it, and a provider refusal comes back with its reason.
Herald's composer: a subject, preview text, segment, tag filter, and template pickers above a Markdown editor on the left and a preview on the right, with Save draft, Send test, Schedule, and Send now buttons.Herald's composer: a subject, preview text, segment, tag filter, and template pickers above a Markdown editor on the left and a preview on the right, with Save draft, Send test, Schedule, and Send now buttons.
The composer: Markdown on the left and, on the right, the email as a reader will see it.

HTML templates

Keep fully designed HTML emails per list. A template uses per-reader variables, must link the reader's unsubscribe URL, runs in a sandbox, and can be the default new emails start on.

A preview you can trust
With a template, the preview comes from the server and is exactly what a reader receives, both the HTML and the plain-text part. Past 102,000 bytes it warns that Gmail would clip the message.
The composer with an HTML template chosen: the Markdown source on the left and, on the right, the server's template preview of a purple-banded StrataForge release notes email with its size, 7.1 KB. An A/B test button sits beside Send test.The composer with an HTML template chosen: the Markdown source on the left and, on the right, the server's template preview of a purple-banded StrataForge release notes email with its size, 7.1 KB. An A/B test button sits beside Send test.
With an HTML template chosen, the preview is rendered by the server, exactly as a reader gets it. On a list with testing on, an A/B test button appears.

Sent once, sent to the right people

A send reaches each active reader once however many tags they carry. Double-clicking Send or a second server racing the scheduler cannot mail anyone twice.

A public archive
A list can publish its sent emails as web pages. An archive page is served sandboxed, so no script in an email can run in the reader's browser.
Herald's Emails page listing emails across the fictional StrataForge Robotics lists with their subject, list, status (sent, scheduled, draft, or sending), send time, recipients, and open and click rates, with a status filter, a New Email button, and paging.Herald's Emails page listing emails across the fictional StrataForge Robotics lists with their subject, list, status (sent, scheduled, draft, or sending), send time, recipients, and open and click rates, with a status filter, a New Email button, and paging.
Emails: drafts, scheduled sends, and sent issues across every list, with their numbers.

Set it up once, then test the subject line

Automations

Start when a reader confirms. Then run steps in order: send an email, wait, add a tag, or remove one.

Illustration with example data: the Welcome series automation on Fleet notes, with its switch On and four lit steps in order: a reader confirms, send email Welcome to StrataForge, add tag Welcomed, and send email A week in: what do you want more of?Illustration with example data: the Welcome series automation on Fleet notes, with its switch On and four lit steps in order: a reader confirms, send email Welcome to StrataForge, add tag Welcomed, and send email A week in: what do you want more of?

Illustration, not the Herald app, with example data. The Welcome series automation on Fleet notes shows a switch set to On and a first node, Trigger: a reader confirms. Three steps appear beneath it, and a dot walks down the chain, lighting each one in order: Send email, Welcome to StrataForge; Add tag, Welcomed; Send email, A week in: what do you want more of? Then the switch slides to Off and the nodes dim.

A trigger, then steps in order.

AI subject-line tests

Ask Mercury 3 for alternative subject lines (if the model is unavailable, Herald suggests simple variations of your line instead), edit or drop any of them, and test them on 5 to 50 percent of the list. Herald sends the one with the best open rate to everyone else, as long as it beats the original by at least 5 percent; if not, the original goes. Off by default for each list.

Illustration with example data: three subject lines tested on 20% of 1,500 readers, 100 for each line; after the two-hour window, line B, What changed for clinics in August, is marked Winner with 38% opens against 31% for the control A and 34% for C, and the other 80% of readers are marked as getting B.Illustration with example data: three subject lines tested on 20% of 1,500 readers, 100 for each line; after the two-hour window, line B, What changed for clinics in August, is marked Winner with 38% opens against 31% for the control A and 34% for C, and the other 80% of readers are marked as getting B.

Illustration, not the Herald app, with example data. A subject line, Release notes: clinic updates, August, is the control, A. Mercury 3 suggests two more, B and C. A bar for 1,500 readers shows 20% testing, split three ways, and 80% waiting. While a clock runs from 0:00 to 2:00, three open-rate bars climb to 31%, 38%, and 34%. Then B is marked Winner, and the waiting 80% turns to read 80% get B.

The winner is chosen by open rate, so turn tracking on first.
Results where you work
A running test shows an A/B badge on the email list. A finished one shows the winning subject line and how each variant did.
Herald's Automations page listing three automations with their list, the Subscriber Confirmed trigger, the number of steps, an on or off switch, and a Delete button.Herald's Automations page listing three automations with their list, the Subscriber Confirmed trigger, the number of steps, an on or off switch, and a Delete button.
Automations: a trigger, then steps in order, with a switch to turn each one on or off.

Honest defaults

SendGrid delivery

Mail goes out through SendGrid. Its bounce, spam-complaint, delivery, open, and click events come back signed, and Herald checks the signature before believing them.

Tracking off until you say so
New lists do not track opens or clicks. Turn tracking on for a list and you get open and click rates on the dashboard and the email list.
Signed webhooks and keys per list
Outbound webhooks fire on subscriber and email events, each signed with its own secret. API keys are per list, stored hashed, and shown once.
Signup that resists bots
The public signup endpoints use a hidden honeypot field and a rate limit per address and endpoint (10 a minute by default). A small Lambda function handles signup forms on static sites.
Herald's Settings page for the Product release notes list: its name, slug, and description, then sending configuration (from name, from and reply-to addresses, mailing address) and branding (logo URL, primary color, header and footer HTML).Herald's Settings page for the Product release notes list: its name, slug, and description, then sending configuration (from name, from and reply-to addresses, mailing address) and branding (logo URL, primary color, header and footer HTML).
Settings: the list's name, sender, mailing address, and branding.

An audit trail

Every change is saved as a record with who did it, so history survives a restart. The Activity page filters it by type and person and updates live.

Herald's Activity page, the audit trail: a count of events recorded, filters for event type and person, a search box, and a list of changes such as email drafted, scheduled, and sent, each with its list and who made it.Herald's Activity page, the audit trail: a count of events recorded, filters for event type and person, a search box, and a list of changes such as email drafted, scheduled, and sent, each with its list and who made it.
Activity: a durable record of every change, who made it, and when.
Screens

See it in light and dark

Real captures of the running tool, with fictional StrataForge Robotics data. They follow your theme.

How it works

From draft to delivered

  1. Collect

    Readers sign up, confirm by email, and land on a list with their tags. Or you import a CSV.

  2. Compose

    Write in Markdown, or pick an HTML template. Preview the email as readers will get it, then send yourself a test.

  3. Send

    Choose everyone, a segment, or tags. Send now, schedule it, or test two subject lines first.

  4. Learn

    Watch signups, open rates, and click rates by list, and read the audit trail to see what changed.

Accessibility

Built so everyone can use Herald.

Herald is a web app on the Renkara design system. It has a skip link as its first Tab stop, labeled controls, no sideways scrolling at 375 pixels, and an automated axe run that finds no critical problems. It also has 9 contrast findings from the design system's badge colors, a 16-pixel row checkbox, and a sound and fireworks effect on live events with no off switch. Nobody has tested it with a screen reader or walked it with only a keyboard, and we do not claim a conformance level.

  • Partly supported

    Keyboard operation

    The first Tab stop on the dashboard is a Skip to main content link, then the Herald link, the five navigation links, the list picker, the New newsletter button, the theme button, and the account menu, in reading order. Two scroll areas that a keyboard could not enter, the Emails table and the signup embed code, were made focusable and named on 10/29/2026. Herald has no keyboard shortcuts of its own. Nobody has walked a whole flow, such as composing and sending, with only a keyboard.

  • Partly supported

    Screen reader landmarks and labels

    Controls carry accessible names: the list picker is Current newsletter, the theme button says what it will do, and the Activity page's Pause and Refresh buttons now contain their visible text in their names. An automated scan finds no critical problems and no missing names. Herald has not been tested with VoiceOver, NVDA, JAWS, or any screen reader, so how the live Activity feed and the toasts read aloud is unknown.

  • Partly supported

    Contrast in light and dark

    Herald's magenta accent measures 5.68 to 1 against white in light mode and 5.91 to 1 against the dark card color, both above 4.5 to 1. The axe scan still reports 9 color-contrast findings: warning-tinted status badges on the dashboard, subscribers, and emails pages, a dark-mode status badge on automations, and the dark-mode red Delete text on settings. Those colors belong to the design system, not Herald, and have not been fixed. The Activity page's dimmed event labels, which were 116 to 200 failing nodes, were fixed on 10/29/2026.

  • Partly supported

    Reduced motion

    The design system's global stylesheet shortens every animation and transition to almost nothing when the system asks for reduced motion. Herald's own fireworks, a canvas animation that plays when a new subscriber arrives, does not check the setting, and the sound that goes with it is on by default with no switch in the app to turn it off.

  • Not yet tested

    Text resize and zoom

    Nobody has tested Herald at larger text sizes or browser zoom. Several tables carry small, fixed-size labels, so large text may crowd or clip them.

  • Partly supported

    Mobile and touch

    At 375 pixels no page scrolls sideways in light or dark, and the navigation collapses behind an Open navigation button. Many targets are smaller than 44 pixels: between 13 and 67 per page, and the Subscribers row checkboxes are 16 pixels. Nobody has used the app on a phone.

Tech specs

Under the hood

Herald technical specification
Backend
  • FastAPI on Python 3.12, with async SQLAlchemy 2 and Alembic migrations
  • PostgreSQL for lists, readers, emails, and the audit trail
  • Valkey for the send queue and rate limits; send, schedule, automation, and webhook workers run inside the API process
  • SendGrid v3 for delivery, with HMAC-SHA256 verification of its event webhooks
  • A Node render service (emailmd: Markdown to MJML to email HTML) that runs beside the API in the same container; if it is down, Herald still sends, with the Markdown as plain text
Frontend
  • React 19, Vite, and TypeScript, on the Renkara design system and Tailwind
  • Recharts for the dashboard
  • Light and dark themes
Email
  • Jinja2 templates in a sandboxed environment, at most 512 KB, each required to link the unsubscribe URL
  • List-Unsubscribe and List-Unsubscribe-Post headers on every message
  • A compliance footer on Markdown emails: unsubscribe link and mailing address
  • Server preview with a Gmail clipping warning
Privacy and security
  • Tracking off by default for each list
  • API keys stored as SHA-256 hashes
  • Archive pages served with a sandbox Content-Security-Policy
  • Auth by single sign-on tokens or per-list API keys
Agents and API
  • 63 agent tools over stdio, relayed through Roost
  • REST under /api/v1 for everything the app does
Stands in for

Buttondown

Works with

Curio: Curio captures links, drafts the blurbs, and assembles an issue, then hands Herald the finished draft to schedule and send.

MCP tools

Built for agents as well as people

Herald ships an MCP server so a coding or writing agent can run your newsletters: draft and preview an email, send a test, manage readers and segments, switch an automation on, and read the numbers.

Lists and settings

  • list_newsletters
  • create_newsletter
  • get_newsletter
  • update_newsletter
  • delete_newsletter

Subscribers

  • list_subscribers
  • create_subscriber
  • get_subscriber
  • update_subscriber
  • delete_subscriber
  • export_subscribers
  • import_subscribers

Tags and segments

  • list_tags
  • create_tag
  • update_tag
  • delete_tag
  • list_segments
  • create_segment
  • get_segment
  • update_segment
  • delete_segment
  • preview_segment_subscribers

Emails and sending

  • list_emails
  • compose_email
  • get_email
  • update_email
  • delete_email
  • send_email
  • schedule_email
  • send_test_email
  • render_preview
  • preview_email
  • get_email_metrics

Templates

  • list_templates
  • get_template
  • create_template
  • update_template
  • delete_template

Automations

  • list_automations
  • create_automation
  • get_automation
  • update_automation
  • delete_automation
  • activate_automation
  • deactivate_automation

A/B tests

  • generate_ab_test_variants
  • start_ab_test
  • get_ab_test_results
  • cancel_ab_test

Analytics

  • get_newsletter_metrics
  • get_analytics_growth
  • get_analytics_engagement

Keys, webhooks, and health

  • list_api_keys
  • create_api_key
  • revoke_api_key
  • list_webhooks
  • create_webhook
  • update_webhook
  • delete_webhook
  • ping_service
  • check_service_health
  • get_my_identity
  • get_diagnostics
FAQ

Questions people ask

Does Herald replace a service like Buttondown?

That is what it was built for: Renkara's own newsletters, from signup to archive, on infrastructure Renkara runs. It does not try to match every feature of a hosted newsletter service.

Whose newsletters are these in the screenshots?

They belong to StrataForge Robotics, the fictional company from the novel The Deferral. The lists, readers, issues, and numbers are made up. No real reader, address, or newsletter appears anywhere on this site, and the screenshots were captured on a copy of Herald that is set up so it cannot send mail.

Do I need an account on another service to send?

Delivery goes through SendGrid, so a Herald installation needs a SendGrid account. Herald verifies SendGrid's signed event webhooks and keeps its own record of bounces and unsubscribes.

Does it track opens and clicks?

Only if you turn tracking on for a list. It is off for every new list, and the unsubscribe link is never rewritten for tracking.

How do I ask about using Herald?

Write to fleet@renkara.com.

Contact

Questions about this tool?

Write to Renkara Media Group and a person will answer.