Skip to content

Account

Email verification template.

Ask a new user to confirm their address with one button and a plain link underneath.

Look

SubjectConfirm your email for Acme

PreviewOne click to finish setting up your account.

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

Right after sign-up, before the account is fully active. It is the first email many people ever get from you, so it should arrive in seconds and ask for one thing.

Get it right

  • Make the link single-use and give it an expiry; 24 hours is common. Say the expiry in the email.
  • Send it straight away. A confirmation that takes minutes loses people at the exact moment they are paying attention.
  • Keep the plain link under the button: some mail programs strip buttons, and people copy links into other browsers.
  • Include nothing promotional. Keep it free of promotion so it stays what it is, a transactional message.

Use it in Mailtruss

Choose New template, pick Verify your email, 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
verify_urlThe one-time link that confirms the address. Create it on your server.https://app.example.com/verify?token=7f3a9cYes
expires_inHow long the link works, in words. Optional; "24 hours" is used when it is missing.24 hoursOptional
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": "verify-email", "look": "mint", "alias": "verify-email", "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: "verify-email", // the alias you gave the template
variables: {
app_name: "Acme",
verify_url: "https://app.example.com/verify?token=7f3a9c",
},
},
},
{ idempotencyKey: "verify-email-<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.

verify-email.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:#30967e!important}.mt-brandtext{color:#30967e!important}.mt-btncell{background:#0b8467!important;border-color:#0b8467!important}.mt-button{color:#ffffff!important}.mt-ghost{background:transparent!important;border-color:#30967e!important}.mt-ghost .mt-button{color:#30967e!important}.mt-badge-neutral{background:#21232a!important;color:#f1f1f4!important}.mt-mark,.mt-stepnum{background:#0b8467!important;color:#ffffff!important}.mt-markdot{background:#ffffff!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:#e4f4ee">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:transparent;mso-hide:all">One click to finish setting up your account.&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:#e4f4ee">
<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:24px;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:#0b8467;border-radius:15px">
<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:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:17px;font-weight:700;letter-spacing:-0.2px;color:#0b8467">{{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-tint" style="background:#eef6f4;border-radius:22px;padding:34px 30px;text-align:left">
<div class="mt-eyebrow" style="font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:12px;font-weight:700;letter-spacing:1.4px;text-transform:uppercase;color:#637672;margin:0 0 12px">Almost there</div>
<h1 class="mt-title" style="margin:0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:32px;font-weight:700;line-height:116%;letter-spacing:-0.6px;text-decoration:none;color:#12302a;text-align:left">Confirm your email address</h1>
<p class="mt-text" style="margin:12px 0 0;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:16px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#637672;text-align:left">Hi {{first_name | there}}, thanks for signing up for {{app_name | our app}}. One click and your account is ready.</p>
</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="#0b8467" style="background:#0b8467;border-radius:40px;">
<a class="mt-button" href="{{verify_url}}" style="display:inline-block;padding:14px 30px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:15px;font-weight:650;line-height:100%;letter-spacing:0px;color:#ffffff;text-decoration:none;text-align:center;border-radius:40px">Confirm email address</a>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 0px">
<p class="mt-text mt-small" style="margin:0 0 14px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:13px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#637672;text-align:left">This link works for {{expires_in | 24 hours}} and can be used once.</p>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 18px">
<div class="mt-linkbox" style="background:#eef6f4;border-radius:10px;padding:13px 16px">
<div class="mt-label" style="margin:0 0 5px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:12px;line-height:150%;color:#637672">Or paste this link into your browser</div>
<a class="mt-link" href="{{verify_url}}" style="font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,'Liberation Mono',monospace;font-size:12px;line-height:150%;color:#0b7f60;text-decoration:none;word-break:break-all">{{verify_url}}</a>
</div>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 0px">
<p class="mt-text mt-small" style="margin:0 0 14px;font-family:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:13px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#637672;text-align:left">If you did not create an account, you can safely ignore this email.</p>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:14px 40px 0">
<div class="mt-rule" style="border-top:1px solid #e5e8e8;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:'Avenir Next','Segoe UI',Candara,'Trebuchet MS',Verdana,sans-serif;font-size:12px;line-height:165%;color:#637672">{{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}}
​
Almost there
Confirm your email address
Hi {{first_name | there}}, thanks for signing up for {{app_name | our app}}. One click and your account is ready.
​
Confirm email address: {{verify_url}}
​
This link works for {{expires_in | 24 hours}} and can be used once.
​
Or paste this link into your browser
{{verify_url}}
​
If you did not create an account, you can safely ignore this email.
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates