The Black Friday sale: $100 off Mimeo. Buy now →

Mimeo is self-hosted email automation software that sends email when someone signs up or buys in your app or store. Your app or store tells your Mimeo about each signup or order, and a flow listening for it sends the email through your own Postmark or Resend account. Give each signup or order its own key, such as the order number, and a retried one never emails anyone twice.

Flows in Mimeo start on any event, sales included, so a trial signup and a repeat order can each get their own email. You build them in the dashboard or with your agent, on your own server.

Your app tells Mimeo what happened, and a flow sends the email

Each signup or order reaches your Mimeo as an event: a short message saying what happened, and to whom.

Your app's signup code and a small handler for your store's order webhook, both on your server, each send one event with its own idempotency key to your Mimeo: signed_up and purchase. Your Mimeo adds or updates the person, puts the event on their timeline, and records the order and lifetime spend. A live flow whose trigger matches sends the email through your own Postmark or Resend account. The same key sent again is answered duplicate and nothing happens; an event marked historical is recorded and starts no flow. Your app or store Signup code runs when they join Order handler turns your store's webhook into an event signed_up purchase each with its own idempotency key Your Mimeo on your server Person added or updated Event on their timeline Order and lifetime spend recorded Live flow, trigger matches tag them, send the email Same key again duplicate nothing happens Marked historical recorded, starts no flow Postmark or Resend your own account Inbox
Fig. 1 · From your app or store to the inbox · diagram
  • A signup sends signed_up, with details like the plan they picked.
  • An order sends purchase, with the product and amount.
  • A store that only offers a webhook (its own message about each sale) needs a small handler on your server to pass each order on. Your agent can write it.

The event adds or updates the person and starts any live flow that listens for it. Mimeo has no direct connection to Stripe or a store; your code or handler is the connection.

Before you start

  • Your Mimeo, running on your server (run it on your own server), with your own Postmark or Resend account for sending.
  • Somewhere that runs on signup and on a paid order: your app's code, or your store's order webhook.
  • Two emails in your library: a welcome and an order thank-you.
  • For the agent tab: Claude Code or Codex, working in your manager repo (Getting yours sets it up).

Steps

Both tabs build the same two flows: a welcome for trial signups and a thank-you for every order.

Build it in Mimeo

1 Name your events, and keep what emails need on the person

Name events in the past tense, from the person's side, and put variations such as the plan in the details, not the name (designing your event names).

An email can't read the event's details, so keep what it needs on the person. For the product: go to People → Fields, click New field, set the key to last_product and the type to text, and click Create field. Your code sends that field with each order.

2 Build the signup flow: once per person

Go to Automation → Flows and click New flow. Name it "Trial welcome", pick Single run ever, and click Create draft.

On the Flow begins box, click Entry rules. Set Starts when this event happens to signed_up, click Only when a detail matches, set plan is exactly trial, and click Save. Then use Add a step here to add an Add tag step for trial and a Send email step with your welcome.

How people enter this flow: when an event happens, starts when signed_up happens, all of these: plan is exactly trial; Don't start this flow on events marked historical, checked; How often: One run per person, ever.
Fig. 2 · The signup flow's entry rules · local install, November 17, 2026

3 Build the order flow: every order

Click New flow again. Name it "Order thank-you", pick Repeat runs allowed, and click Create draft. In Entry rules, set Starts when this event happens to purchase and save. Add an Add tag step for customer and a Send email step with the thank-you.

In the thank-you, insert the last_product field with a fallback such as "from us", so an order without it still reads well (email variables).

4 Rehearse both, then make them live

A rehearsal shows what a flow would do for a real person, and changes nothing.

On the signup flow, click Rehearse it, pick someone on your list, keep the plan set to trial in the event details, and click Run it. In the test it said "Trigger matches", "Would add the tag trial" and "Would queue "Welcome to Acme"". With the plan set to free, it said the trigger doesn't match and nothing would happen. Rehearse the order flow the same way.

Then click Make it live on each and confirm.

The Trial welcome flow, live: when signed_up happens matching plan is trial, tag as trial, send Welcome to Acme. The rehearsal for plan trial says Trigger matches, Detail plan is trial, Would add the tag trial, Would queue Welcome to Acme.
Fig. 3 · The signup flow and its rehearsal · local install, November 17, 2026

More on rehearsals: test a flow before it sends.

5 Send a test signup and a test order

Your server needs a token. Click your email address at the bottom of the sidebar, choose Settings, then Agents & API → API tokens, name it and click Create token. It's shown once and has full access, so keep it in your server's settings, never in a page.

Then ask your agent to have your code send a test trial signup and a test order for the same address, each with its own key: the account ID for the signup, the order number for the order. The event contract gives your agent the exact shape.

In the test, the person got both tags and both emails within a minute, and their page showed the order. Sending each again with the same key changed nothing.

Ada's person page, Lifetime spend $49, Timeline: Sent Thanks for your order, accepted; Sent Welcome to Acme, accepted; Order thank-you entered and exited with tag customer; Trial welcome entered and exited with tag trial; purchase, product starter_kit, amount_cents 4900, external_id ord_5001; field_changed last_product to Starter kit; signed_up, plan trial.
Fig. 4 · One signup and one order on the person's timeline · local install, November 17, 2026

6 Check what listens before you rename an event

Renaming an event in your code quietly stops every flow that listens for the old name.

Go to Events → Events and click purchase. Data shape shows what your orders send, and Used in lists every flow that starts on it or waits for it, live or not. Check it before a rename, or when an email didn't go out.

Events, purchase: 124 occurrences; Data shape with amount_cents, product, external_id, payment and currency; Used in 4 flows: Course onboarding triggers it, Order thank-you triggers it, Purchase receipt triggers it, SaaS free trial nurture waits on it at a gate.
Fig. 5 · What sends purchase, and what listens for it · local install, November 17, 2026

Build it with your agent

Your agent builds and checks the flows through your manager repo or the MCP server, and can write the code in your app that sends the events. The event contract tells it the shape.

1 Build both flows

Tell your agent
Build a single-run flow that sends Welcome to Acme when signed_up arrives with plan trial, and a repeat-run flow that sends Thanks for your order on every purchase. Rehearse both and show me, but don't make them live.

What to look for: two draft flows, and a rehearsal that matches a trial signup and skips a free one.

2 Create the token yourself

Create it in Settings → Agents & API → API tokens, as in the other tab. Keep it out of the chat and out of your repo.

3 Have your agent write the code that sends events

Tell your agent
Write the code in our app that sends signed_up and purchase events to our Mimeo, with the account ID and the order number as idempotency keys and last_product as a person field. Read the token from an environment variable.

What to look for: code in your app, not your manager repo, with one key per signup or order, never per customer.

4 Load past orders safely

Tell your agent
Before we load last year's orders, check that every event in the backfill is marked historical and has its own key.

5 Go live, then check what listens

Tell your agent
Make both flows live. Then tell me which flows and segments listen for purchase.

A retry never emails anyone twice, as long as each event has its own key

Mimeo ignores an event whose key it has already seen, so a retried webhook can't send a second email.

  • Sent twice with the same key: one event, one flow run, one email.
  • Resent without a key: a new event. The order's own ID kept one purchase on record, but the thank-you went out twice.
  • A key reused for a different event: the new event is quietly dropped. Use the order number or account ID, never the customer's ID.

Past signups and orders come in without emailing anyone

Events marked historical are recorded and start nothing.

Ask your agent to send old events marked historical, each with its date and its own key. In the test, two old orders and a signup landed on the timeline with their real dates, and no flow started, even with both flows live.

Cy's person page, Lifetime spend $68, Timeline: two purchase events, refill_pack 1900 two years ago and starter_kit 4900 three years ago, and nothing else: no flow, no tag, no email.
Fig. 6 · A backfilled customer: two past orders, no flow, no email · local install, November 17, 2026

Your agent can send up to 100 at a time; one bad event fails only itself (batching, backfilling). Moving a whole list from another platform is a different job: migrate from Mailchimp or Kit.

A buyer who unsubscribed gets no follow-up

Mimeo records their order and drops the thank-you at send time (never email people who unsubscribed).

Every email Mimeo sends is marketing mail. Receipts, order confirmations and password resets stay with your store or app (transactional vs marketing email). For ideas on what to send after a sale, see post-purchase emails.

When something else fits better

Limits

  • Something you run turns each signup or order into an event. Mimeo doesn't connect to a store or Stripe for you.
  • Trials, renewals and subscriptions are separate money events, covered in the event contract.
  • Tested on one local install with demo data and the test provider, so nothing was delivered. No real store, Stripe webhook or live handler was used, and the agent prompts weren't run with an agent.

Facts, checked

Fact Value Source Checked
Release tested Mimeo 0.3.7 Changelog
Events Tested: add or update the person and start matching live flows; an order adds to lifetime spend Event contract, lifetime spend
Flows Tested: matching on plan; one welcome per person, a thank-you per order; rehearsals change nothing Triggers, runs, rehearsal
Keys Tested: a repeated key changes nothing; a reused key keeps the first event; an order resent without a key sent a second thank-you Fields, purchase
Past events Tested: historical events started nothing; batches of up to 100, one bad event fails only itself Backfilling, batching
Emails Tested: can't read event details; can read person fields. A buyer who unsubscribed gets no follow-up Emails, guards
Events and tokens Seen in the app: Used in, on Events → Events. Tested: tokens are shown once, with full access Activity & events, API

Next

Buy now
Sources
  1. The event contract. Checked .
  2. Event reference. Checked .
  3. Activity & events. Checked .
  4. Flows. Checked .
  5. Emails. Checked .

Powerful email automation you fully control.

Buy now