📧 MailGen

Upload HTML email templates → Get email rendering API endpoints instantly

📋 My Templates

📭

No templates yet

👈

Select a template to view details

Or upload a new one to get started

📤 Upload HTML Email Template

Upload an HTML email file with {{variable}} Handlebars placeholders. MailGen will parse it and create a dedicated email rendering API endpoint with automatic CSS inlining.

✉️

Drop your HTML email template here or click to browse

🧪 Test Email Rendering

Inline CSS (for email clients)
JSON response

👁 Email Preview

🚀 How MailGen Works

1

Upload HTML

Upload an HTML email template with {{variable}} Handlebars placeholders for dynamic content.

2

Get Schema

MailGen parses your template and generates a JSON payload schema showing all required variables.

3

Call API

POST your data to the generated endpoint. MailGen renders the HTML with your data and inlines CSS.

4

Get Email HTML

Receive email-ready HTML with inlined CSS — compatible with all major email clients.

📚 API Reference

📡 Endpoints
GET /api/templates — List all templates POST /api/templates — Upload new template (multipart: html file + name) GET /api/templates/:slug — Get template details, schema & sample payload GET /api/templates/:slug/source — Get raw HTML source with {{placeholders}} POST /api/templates/:slug/render — Render email HTML (JSON body = template data) POST /api/templates/:slug/preview — Preview rendered HTML (no CSS inlining) DEL /api/templates/:slug — Delete a template GET /healthz — Health check
⚙️ Render Options (query params on /render)
?inlineCss=true|false — Inline CSS styles (default: true, recommended for email) &format=json — Return JSON wrapper with { html, template, renderedAt }
✏️ Template Syntax (Handlebars)
Simple variable: {{companyName}} Nested object: {{address.city}} Loop: {{#each items}} ... {{name}} ... {{/each}} Conditional: {{#if showDiscount}} ... {{/if}} Helpers: {{uppercase name}} {{lowercase status}} {{year}} {{now}}
🎯 Built-in Helpers
{{eq a b}} — Equality check {{neq a b}} — Not equal {{gt a b}} — Greater than {{lt a b}} — Less than {{and a b}} — Logical AND {{or a b}} — Logical OR {{uppercase str}} — Convert to UPPERCASE {{lowercase str}} — Convert to lowercase {{year}} — Current year (e.g. 2026) {{now}} — Today's date (YYYY-MM-DD)
💻 Quick Start Example
# 1. Upload a template curl -X POST /api/templates \ -F "html=@welcome-email.html" \ -F "name=Welcome Email" # 2. Render email HTML curl -X POST /api/templates/welcome-email/render \ -H "Content-Type: application/json" \ -d '{"recipientName":"John","companyName":"Acme"}' \ --output welcome.html # 3. Or get JSON response curl -X POST /api/templates/welcome-email/render?format=json \ -H "Content-Type: application/json" \ -d '{"recipientName":"John","companyName":"Acme"}'

💡 CSS Inlining

MailGen uses Juice to automatically inline <style> blocks into element-level style="" attributes. This ensures maximum compatibility with email clients like Gmail, Outlook, and Apple Mail, which strip <style> tags. CSS inlining is enabled by default on the /render endpoint. Use ?inlineCss=false to disable it.