Skip to content

Account

Welcome email template.

A short first message that points to the one thing to do next.

Look

SubjectWelcome to Acme

PreviewYour account is ready. Here is where to start.

Shown inApple Mail and iPhone Mail switch automatically

The preview uses example data, so no real names or numbers. Mail programs differ: send one to your own inbox before you rely on it.

When to send it

When an account is confirmed (not when it is created, so it does not compete with the verification email). It sets the tone for everything that follows.

Get it right

  • Lead with one next step and one button. A list of five things gets none of them done.
  • Set a reply-to address that a person reads. Replies to a welcome email are often the first honest feedback you get.
  • Keep it short. The product is the welcome; the email only shows the door.
  • Leave out anything you cannot keep up, such as a promise of a reply within an hour.

Use it in Mailtruss

Choose New template, pick Welcome, change the words and colours, and publish. 3,000 emails a month are free, with no credit card.

Variables

Wrap a name in double braces and Mailtruss fills it in when you send. A value after a bar is the fallback when you leave it out, such as {{first_name | there}}. Values are escaped, so a name with markup in it cannot break the message.

VariableWhat it isExampleNeeded?
app_nameYour product or company name.AcmeYes
first_nameThe person's first name. Optional; the email says "there" without it.AnaOptional
start_urlWhere the person should go first, such as their dashboard or a setup page.https://app.example.com/startYes
support_emailWhere replies and questions go. Optional; the help note is hidden when it is not set.help@example.comOptional
footer_textThe small print at the bottom, such as your company name and postal address. Optional: a short note about why the person got this email is used when you leave it out.Acme Inc, 1 Main Street, SpringfieldOptional

Create it and send it

Create the template from this starter with one request (or from the dashboard), then send it by its alias with your values. Only the published version is ever sent. Other languages are on send email by language.

Create the template
curl -X POST https://mailtruss.com/api/v1/templates \
-H "Authorization: Bearer $MAILTRUSS_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "starter": "welcome", "look": "studio", "alias": "welcome", "publish": true }'
send.ts
import { MailClient } from "mailtruss";
​
const mail = new MailClient({ apiKey: process.env.MAILTRUSS_API_KEY! });
​
await mail.emails.send(
{
from: "Acme <hello@yourdomain.com>",
to: "person@example.com",
template: {
id: "welcome", // the alias you gave the template
variables: {
app_name: "Acme",
start_url: "https://app.example.com/start",
},
},
},
{ idempotencyKey: "welcome-<your-event-id>" }, // makes retries safe
);

The HTML and the text

This is exactly what the starter produces. Copy it into any system that sends HTML, or use it in Mailtruss to keep editing visually.

welcome.html
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
<style>@media only screen and (max-width:520px){.mt-card{width:100%!important;border-radius:0!important}.mt-px{padding-left:22px!important;padding-right:22px!important}.mt-col{display:block!important;width:100%!important;padding:0 0 18px 0!important}.mt-hero,.mt-section{padding:24px 20px!important}.mt-title{font-size:26px!important}}@media (prefers-color-scheme:dark){.mt-pagebg,.mt-page{background:#0e0f12!important}.mt-card{background:#17181c!important;border-color:#2b2d34!important}.mt-title,.mt-subtitle,.mt-heading,.mt-value,.mt-quote{color:#f1f1f4!important}.mt-text,.mt-li,.mt-list{color:#cfd0d8!important}.mt-label,.mt-small,.mt-footer,.mt-unsub,.mt-footer a{color:#9b9da8!important}.mt-rule{border-color:#2b2d34!important}.mt-tone-tint,.mt-tone-card{background:#21232a!important;border-color:#2b2d34!important}.mt-tone-tint .mt-title,.mt-tone-card .mt-title{color:#f1f1f4!important}.mt-code,.mt-codeblock,.mt-linkbox{background:#111216!important;color:#f1f1f4!important}.mt-inline-code{background:#21232a!important;color:#f1f1f4!important}.mt-link{color:#88898a!important}.mt-brandtext{color:#88898a!important}.mt-btncell{background:#f1f1f4!important;border-color:#f1f1f4!important}.mt-button{color:#111214!important}.mt-ghost{background:transparent!important;border-color:#88898a!important}.mt-ghost .mt-button{color:#88898a!important}.mt-badge-neutral{background:#21232a!important;color:#f1f1f4!important}.mt-mark,.mt-stepnum{background:#f1f1f4!important;color:#111214!important}.mt-markdot{background:#111214!important}.mt-tone-accent,.mt-tone-dark{border:1px solid #2b2d34!important}.mt-co-info{background:#1f2b44!important;color:#c8d7f3!important}.mt-co-success{background:#192f23!important;color:#c0dbc8!important}.mt-co-warning{background:#3a2d1d!important;color:#ebd9c0!important}.mt-co-danger{background:#3c1e1f!important;color:#edc6c4!important}}</style>
</head>
<body class="mt-page" style="margin:0;padding:0;background:#f6f6f7">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:transparent;mso-hide:all">Your account is ready. Here is where to start.&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;&nbsp;&zwnj;</div>
<table class="mt-pagebg" role="presentation" width="100%" cellpadding="0" cellspacing="0" style="background:#f6f6f7">
<tr>
<td align="center" style="padding:32px 12px">
<table class="mt-card" role="presentation" width="600" cellpadding="0" cellspacing="0" style="width:100%;max-width:600px;background:#ffffff;border-radius:14px;border:1px solid #e6e6ea;border-collapse:separate">
<tr>
<td style="height:34px;line-height:1px;font-size:1px">&nbsp;</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 22px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" >
<tr>
<td style="padding:0 10px 0 0;vertical-align:middle">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-mark" width="30" height="30" align="center" valign="middle" style="width:30px;height:30px;background:#111214;border-radius:11px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-markdot" width="10" height="10" style="width:10px;height:10px;line-height:10px;font-size:1px;background:#ffffff;border-radius:50%">&nbsp;</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
<td class="mt-brandtext" style="vertical-align:middle;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:17px;font-weight:700;letter-spacing:-0.2px;color:#111214">{{app_name | Your app}}</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 22px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate">
<tr>
<td class="mt-hero mt-tone-accent" style="background:#111214;background-image:linear-gradient(135deg,#111214 0%,#0c0d0e 100%);border-radius:12px;padding:34px 30px;text-align:left">
<div class="mt-eyebrow" style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:12px;font-weight:700;letter-spacing:1.4px;text-transform:uppercase;color:#cbcbcb;margin:0 0 12px">You are in</div>
<h1 class="mt-title" style="margin:0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:30px;font-weight:650;line-height:116%;letter-spacing:-0.8px;text-decoration:none;color:#ffffff;text-align:left">Welcome, {{first_name | there}}</h1>
<p class="mt-text" style="margin:12px 0 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:16px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#cbcbcb;text-align:left">Your account on {{app_name | our app}} is ready. The quickest way to see what it can do is to start with one small thing.</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 2px">
<table class="mt-steps" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td width="42" valign="top" style="width:42px;padding:0 14px 18px 0">
<div class="mt-stepnum" style="width:28px;height:28px;border-radius:50%;background:#111214;color:#ffffff;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:13px;font-weight:700;line-height:28px;text-align:center">1</div>
</td>
<td valign="top" style="padding:3px 0 18px">
<div class="mt-value" style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:15px;font-weight:650;line-height:140%;color:#1c1d21">Finish your profile</div>
<div class="mt-label" style="margin:3px 0 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;line-height:150%;color:#727375">Add your name and a photo so teammates recognise you.</div>
</td>
</tr>
<tr>
<td width="42" valign="top" style="width:42px;padding:0 14px 18px 0">
<div class="mt-stepnum" style="width:28px;height:28px;border-radius:50%;background:#111214;color:#ffffff;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:13px;font-weight:700;line-height:28px;text-align:center">2</div>
</td>
<td valign="top" style="padding:3px 0 18px">
<div class="mt-value" style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:15px;font-weight:650;line-height:140%;color:#1c1d21">Invite your team</div>
<div class="mt-label" style="margin:3px 0 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;line-height:150%;color:#727375">Work is easier with the people you work with.</div>
</td>
</tr>
<tr>
<td width="42" valign="top" style="width:42px;padding:0 14px 18px 0">
<div class="mt-stepnum" style="width:28px;height:28px;border-radius:50%;background:#111214;color:#ffffff;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:13px;font-weight:700;line-height:28px;text-align:center">3</div>
</td>
<td valign="top" style="padding:3px 0 18px">
<div class="mt-value" style="font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:15px;font-weight:650;line-height:140%;color:#1c1d21">Look around</div>
<div class="mt-label" style="margin:3px 0 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;line-height:150%;color:#727375">Start with one small thing and build from there.</div>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 20px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate;">
<tr>
<td class="mt-btncell" align="center" bgcolor="#111214" style="background:#111214;border-radius:9px;">
<a class="mt-button" href="{{start_url}}" style="display:inline-block;padding:13px 24px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:15px;font-weight:550;line-height:100%;letter-spacing:0px;color:#ffffff;text-decoration:none;text-align:center;border-radius:9px">Get started</a>
</td>
</tr>
</table>
</td>
</tr>
{{#if support_email}}
<tr>
<td class="mt-px" style="padding:0px 40px 18px">
<div class="mt-callout mt-co-info" style="background:#eef4ff;border-left:4px solid #3b6fd4;border-radius:8px;padding:15px 18px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;line-height:155%;color:#17305f">
<p style="margin:0">Questions? Write to {{support_email}} and we will get back to you.</p>
</div>
</td>
</tr>
{{/if}}
<tr>
<td class="mt-px" style="padding:14px 40px 0">
<div class="mt-rule" style="border-top:1px solid #e6e6e7;line-height:0;font-size:0;height:0">&nbsp;</div>
</td>
</tr>
<tr>
<td class="mt-px mt-footer" style="padding:16px 40px 34px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:12px;line-height:165%;color:#727375">{{footer_text | You are receiving this email because of your account.}}</td>
</tr>
</table>
</td>
</tr>
</table>
</body>
</html>
Plain text
{{app_name | Your app}}
​
You are in
Welcome, {{first_name | there}}
Your account on {{app_name | our app}} is ready. The quickest way to see what it can do is to start with one small thing.
​
1. Finish your profile - Add your name and a photo so teammates recognise you.
2. Invite your team - Work is easier with the people you work with.
3. Look around - Start with one small thing and build from there.
​
Get started: {{start_url}}
​
{{#if support_email}}Questions? Write to {{support_email}} and we will get back to you.{{/if}}
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates