Creating Your First Email Template

Email templates in MigoSMTP are reusable HTML email designs that you can store, version, and call by ID when sending through the API — eliminating the need to include the full HTML in every send request. This article walks you through creating, saving, and using your first email template.

Why Use Templates?

Step 1 — Navigate to Templates

1. Log in to MigoSMTP via the Rackwave portal SSO.
2. Click Templates in the left sidebar (under the Email Management section).
3. Click Create Template or New Template.

Step 2 — Fill in Template Details

Step 3 — Build Your Template Content

You have two options for building the template:

1. HTML Editor — paste or write raw HTML directly. Best for developers who have an existing HTML design or prefer full control.
2. Drag-and-Drop Builder — visual block-based editor. Best for non-technical users or quick template creation without writing HTML.

See the respective articles for detailed guides on each editor.

Step 4 — Add Template Variables

Variables allow you to personalise each email sent using this template. Variables are written as {{variable_name}} anywhere in the subject, HTML body, or plain text body:

<!-- Example template HTML -->
<h2>Hi {{first_name}},</h2>
<p>Your order <strong>#{{order_id}}</strong> has been confirmed.</p>
<p>Total: <strong>{{currency}}{{order_total}}</strong></p>
<p>Expected delivery: {{delivery_date}}</p>
<a href="{{tracking_url}}">Track your order</a>

Define default fallback values for variables in case a value is not provided in the send request — this prevents {{variable_name}} appearing literally in the email:

Step 5 — Preview with Sample Data

1. After building your template, click the Preview button.
2. Enter sample values for each variable in the preview panel.
3. The preview renders the template exactly as recipients will see it.
4. Toggle between desktop and mobile preview modes.
5. Send a test email to your inbox with the sample data to verify rendering in your own email client.

Step 6 — Publish and Use via API

1. Click Save & Publish. The template is now available for use.
2. Copy the Template ID from the template details page.
3. Use the template in your API calls:

POST https://api.migosmtp.com/v1/email/send
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "from":        "orders@yourcompany.com",
  "to":          "customer@example.com",
  "template_id": "order-confirmation-v2",
  "variables": {
    "first_name":   "Rahul",
    "order_id":     "12345",
    "order_total":  "1,499.00",
    "currency":     "₹",
    "delivery_date":"15 June 2026",
    "tracking_url": "https://yourcompany.com/track/12345"
  }
}

Template Versioning

MigoSMTP keeps a version history of every template. If a template update breaks something in production, you can roll back to a previous version:

1. Open the template in the Templates section.
2. Click Version History.
3. Select the version you want to restore.
4. Click Restore This Version.

Next Steps

• Using the HTML email editor
• Drag-and-drop template builder guide
• Template variables & personalisation
• Email API Reference