Skip to content

Security

Email change confirmation template.

Confirm that a new address belongs to the person, and say what stays the same until they do.

Look

SubjectConfirm your new email address for Acme

PreviewConfirm this address to finish changing your email.

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 someone changes the email on their account. Send this to the new address, and a short notice to the old one.

Get it right

  • Send the confirmation to the new address, so only someone who can read it can take it over.
  • Keep the old address in place until the new one is confirmed, and say so.
  • Also email the old address that a change was requested, with a way to cancel it.
  • Make the link single-use and give it an expiry.

Use it in Mailtruss

Choose New template, pick Confirm a new email address, 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
old_emailThe address currently on the account.ana@old-domain.exampleYes
new_emailThe address being added.ana@new-domain.exampleYes
confirm_urlThe one-time link that confirms the new address.https://app.example.com/confirm-email?token=51ad07Yes
expires_inHow long the link works, in words. Optional.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": "email-change-confirm", "look": "paper", "alias": "email-change-confirm", "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: "email-change-confirm", // the alias you gave the template
variables: {
app_name: "Acme",
old_email: "ana@old-domain.example",
new_email: "ana@new-domain.example",
confirm_url: "https://app.example.com/confirm-email?token=51ad07",
},
},
},
{ idempotencyKey: "email-change-confirm-<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.

email-change-confirm.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:#a9806c!important}.mt-brandtext{color:#a9806c!important}.mt-btncell{background:#f1f1f4!important;border-color:#f1f1f4!important}.mt-button{color:#111214!important}.mt-ghost{background:transparent!important;border-color:#a9806c!important}.mt-ghost .mt-button{color:#a9806c!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:#efe8da">
<div style="display:none;max-height:0;overflow:hidden;opacity:0;color:transparent;mso-hide:all">Confirm this address to finish changing your email.&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:#efe8da">
<tr>
<td align="center" style="padding:32px 12px">
<table class="mt-card" role="presentation" width="580" cellpadding="0" cellspacing="0" style="width:100%;max-width:580px;background:#fffdf8;border-radius:4px;border:1px solid #e1d6c2;border-collapse:separate">
<tr>
<td style="height:41px;line-height:1px;font-size:1px">&nbsp;</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 22px">
<div class="mt-brandtext" style="font-family:Georgia,'Times New Roman',Times,serif;font-size:17px;font-weight:700;letter-spacing:-0.2px;color:#7a3b1d;text-align:left">{{app_name | Your app}}</div>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 8px">
<h1 class="mt-title" style="margin:0;font-family:Georgia,'Times New Roman',Times,serif;font-size:32px;font-weight:700;line-height:114%;letter-spacing:-0.5px;text-decoration:none;color:#2b2118;text-align:left">Confirm your new email address</h1>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 0px">
<p class="mt-text" style="margin:0 0 14px;font-family:Georgia,'Times New Roman',Times,serif;font-size:16px;font-weight:400;line-height:170%;letter-spacing:0px;text-decoration:none;color:#3a2e22;text-align:left">Hi {{first_name | there}}, you asked to change the email address on your account at {{app_name | our app}}.</p>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 6px">
<table class="mt-columns" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-col" width="50%" valign="top" style="padding:0 10px 0 0px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-px" style="padding:0px 0px 0px">
<p class="mt-text" style="margin:0 0 14px;font-family:Georgia,'Times New Roman',Times,serif;font-size:16px;font-weight:400;line-height:170%;letter-spacing:0px;text-decoration:none;color:#3a2e22;text-align:left">
<strong style="font-weight:700">Current</strong>
<br>
{{old_email}}
</p>
</td>
</tr>
</table>
</td>
<td class="mt-col" width="50%" valign="top" style="padding:0 0px 0 10px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-px" style="padding:0px 0px 0px">
<p class="mt-text" style="margin:0 0 14px;font-family:Georgia,'Times New Roman',Times,serif;font-size:16px;font-weight:400;line-height:170%;letter-spacing:0px;text-decoration:none;color:#3a2e22;text-align:left">
<strong style="font-weight:700">New</strong>
<br>
{{new_email}}
</p>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 20px">
<table role="presentation" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate;">
<tr>
<td class="mt-btncell" align="center" bgcolor="#7a3b1d" style="background:#7a3b1d;border-radius:2px;">
<a class="mt-button" href="{{confirm_url}}" style="display:inline-block;padding:14px 28px;font-family:Georgia,'Times New Roman',Times,serif;font-size:15px;font-weight:600;line-height:100%;letter-spacing:0px;color:#ffffff;text-decoration:none;text-align:center;border-radius:2px">Confirm new address</a>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 0px">
<p class="mt-text mt-small" style="margin:0 0 14px;font-family:Georgia,'Times New Roman',Times,serif;font-size:13px;font-weight:400;line-height:170%;letter-spacing:0px;text-decoration:none;color:#736c64;text-align:left">This link works for {{expires_in | 24 hours}} and can be used once. Until you confirm it, your account keeps using {{old_email}}.</p>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 48px 18px">
<div class="mt-callout mt-co-warning" style="background:#fbf1dc;border-left:4px solid #b7791f;border-radius:4px;padding:15px 18px;font-family:Georgia,'Times New Roman',Times,serif;font-size:14px;line-height:155%;color:#5c3a05">
<p style="margin:0">If you did not ask for this, do not click the link. Your email will not change.</p>
</div>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:14px 48px 0">
<div class="mt-rule" style="border-top:1px solid #e8e5df;line-height:0;font-size:0;height:0">&nbsp;</div>
</td>
</tr>
<tr>
<td class="mt-px mt-footer" style="padding:16px 48px 41px;font-family:Georgia,'Times New Roman',Times,serif;font-size:12px;line-height:165%;color:#736c64">{{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}}
​
Confirm your new email address
​
Hi {{first_name | there}}, you asked to change the email address on your account at {{app_name | our app}}.
​
Current
{{old_email}}
​
New
{{new_email}}
​
Confirm new address: {{confirm_url}}
​
This link works for {{expires_in | 24 hours}} and can be used once. Until you confirm it, your account keeps using {{old_email}}.
​
If you did not ask for this, do not click the link. Your email will not change.
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates