Bulk Email Marketing.

Connect a sending provider

Go to Storefront → Marketing → Email → Setup. Pick a provider:

You also set From address, From name, and Reply-to on the same page. MeshX generates a webhook URL per provider — paste this into Resend/SES so opens, clicks, bounces, and complaints flow back into MeshX.

Build your audience

Every campaign sends to one of two audience pools:

• Storefront customers — anyone who opted in at checkout or via your newsletter signup on the storefront. These are auto-captured with consent timestamps.
• Imported audience — a CSV you upload. Go to Marketing → Audience → Import.

Import sources

When importing, tag the source so you can audit your lists later. Built-in source tags include:

• etsy_export — emails from your Etsy buyer-export CSV
• amazon_export — emails from Amazon reports
• direct — anything else (Instagram DMs, WhatsApp, market stalls, etc.)

Create a campaign

Go to Marketing → Email → New campaign. Fields:

Template variables

These are substituted per-recipient at send time:

• {{first_name}} — customer's first name (falls back to "there" if unknown)
• {{email}} — recipient address
• {{unsubscribe_url}} — one-click unsubscribe link (required by law — include it in every campaign)

How sending works

When you hit Send now, MeshX queues the campaign. A cron job (/api/cron/marketing/send) runs every 5 minutes and picks up pending sends:

• The cron divides your audience by your throttle to compute a per-tick batch (hard ceiling: 5,000 emails per tick)
• Each row is delivered through your connected provider (Resend or SES)
• The 7-day frequency cap suppresses anyone who's already received an email from your tenant in the last week
• Unsubscribed addresses are skipped automatically
• Send results (success / error) are recorded per recipient for analytics

Campaign analytics

Each campaign card on the Marketing → Email dashboard shows live counts, driven by provider webhooks:

• Recipients — total addresses targeted
• Delivered — accepted by the recipient's mail server
• Opens — unique opens (tracking pixel; some clients block this)
• Clicks — unique link clicks
• Failed — bounces or provider errors (auto-suppressed from future sends)
• Unsubscribes — clicks on the {{unsubscribe_url}} link

Open a campaign to drill into a per-recipient log of who got it, who opened, and who clicked.