Skip to content

Security

New sign-in alert email template.

Tell someone their account was signed in from a new device, with the details and a way to lock it down.

Look

SubjectNew sign-in to your account

PreviewWe noticed a sign-in from a new device.

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 a sign-in comes from a device or place the account has not used before. It is one of the few emails people are glad to get, as long as it is not sent for every sign-in.

Get it right

  • Send it only for new devices or places. If it arrives every time, people stop reading it, including the time it matters.
  • Show the device, the approximate place and the time, so the owner can tell at a glance whether it was them.
  • Give one clear way to secure the account, and keep the first line calm.
  • Treat the place as approximate: it comes from an IP address and is often the provider's location, not the person's.

Use it in Mailtruss

Choose New template, pick New sign-in alert, 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
deviceThe browser and system used.Chrome on WindowsYes
locationAn approximate place.Austin, United StatesYes
ip_addressThe IP address. Optional.203.0.113.24Optional
signed_in_atWhen it happened, in the person's time zone if you know it.16 November 2026, 14:32 UTCYes
secure_urlA link to change the password and sign out other sessions.https://app.example.com/securityYes
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": "new-sign-in-alert", "look": "studio", "alias": "new-sign-in-alert", "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: "new-sign-in-alert", // the alias you gave the template
variables: {
app_name: "Acme",
device: "Chrome on Windows",
location: "Austin, United States",
signed_in_at: "16 November 2026, 14:32 UTC",
secure_url: "https://app.example.com/security",
},
},
},
{ idempotencyKey: "new-sign-in-alert-<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.

new-sign-in-alert.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">We noticed a sign-in from a new device.&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-tint" style="background:#eeeeef;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:#727375;margin:0 0 12px">Security</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:#1c1d21;text-align:left">New sign-in to your account</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:#727375;text-align:left">Hi {{first_name | there}}, your account on {{app_name | our app}} was just signed in to from a device we have not seen before.</p>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 20px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0" style="border-collapse:separate">
<tr>
<td class="mt-section mt-tone-card" style="background:#ffffff;border-radius:12px;border:1px solid #e6e6e7;padding:26px 28px 12px">
<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-px" style="padding:0px 0px 14px">
<table class="mt-table" role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr>
<td class="mt-label" style="padding:11px 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#727375;text-align:left">Device</td>
<td class="mt-value" align="right" style="padding:11px 0;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#1c1d21;text-align:right">{{device | Unknown device}}</td>
</tr>
<tr>
<td class="mt-label mt-rule" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#727375;text-align:left">Near</td>
<td class="mt-value mt-rule" align="right" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#1c1d21;text-align:right">{{location | Unknown location}}</td>
</tr>
<tr>
<td class="mt-label mt-rule" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#727375;text-align:left">IP address</td>
<td class="mt-value mt-rule" align="right" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#1c1d21;text-align:right">{{ip_address | Unknown}}</td>
</tr>
<tr>
<td class="mt-label mt-rule" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#727375;text-align:left">Time</td>
<td class="mt-value mt-rule" align="right" style="padding:11px 0;border-top:1px solid #e6e6e7;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:14px;font-weight:400;line-height:140%;color:#1c1d21;text-align:right">{{signed_in_at | Just now}}</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
<tr>
<td class="mt-px" style="padding:0px 40px 0px">
<p class="mt-text" style="margin:0 0 14px;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif;font-size:15px;font-weight:400;line-height:165%;letter-spacing:0px;text-decoration:none;color:#3b3d44;text-align:left">If this was you, there is nothing to do. If it was not, secure your account now.</p>
</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="{{secure_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">Secure my account</a>
</td>
</tr>
</table>
</td>
</tr>
<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}}
​
Security
New sign-in to your account
Hi {{first_name | there}}, your account on {{app_name | our app}} was just signed in to from a device we have not seen before.
​
Device: {{device | Unknown device}}
Near: {{location | Unknown location}}
IP address: {{ip_address | Unknown}}
Time: {{signed_in_at | Just now}}
​
If this was you, there is nothing to do. If it was not, secure your account now.
​
Secure my account: {{secure_url}}
​
{{footer_text | You are receiving this email because of your account.}}

More templates

All email templates