Notifications
Email Notifications

Email Notifications

TrackLogy sends branded email notifications to your customers whenever their shipment status changes. Emails are sent through Brevo (formerly Sendinblue) using your own Brevo API key — so they come from your domain, not TrackLogy's.

How Email Notifications Work

  1. A shipment's status changes (e.g. carrier picks it up)
  2. The new status maps to an email template key (e.g. in_transit)
  3. If this status is enabled in your store's email settings, an email is queued
  4. TrackLogy checks that the shipment has a customer_email set
  5. If the same status email hasn't been sent before for this shipment, it sends via Brevo
  6. The email uses your custom template (or a built-in default) with variables substituted

The same status email is sent at most once per shipment. This prevents duplicate notifications if a carrier briefly re-reports an earlier status.

Setting Up Brevo

Create a Brevo account

Sign up at brevo.com (opens in a new tab) if you don't have one. The free tier allows 300 emails/day.

Get your Brevo API key

In Brevo, go to SMTP & API → API Keys and create a new API key.

Add the key to TrackLogy

In your TrackLogy dashboard, go to Store Settings → Email for the store you want to configure. Paste your Brevo API key.

Set your sender details

Enter your sender name (e.g. "Your Store Name") and sender email address. Make sure the sender domain is verified in Brevo.

Per-Status Enable/Disable

You can independently enable or disable email notifications for each status. By default:

StatusEmail Enabled
in_transitYes
out_for_deliveryYes
deliveredYes
exceptionYes
failureYes
return_to_senderYes
on_holdYes

Toggle these in Dashboard → Store Settings → Email or via the notification settings API.

Custom Email Templates

For each status, you can customize:

FieldDescription
subjectEmail subject line (supports template variables)
headingLarge heading inside the email body
bodyMain email body text (supports template variables)
button_textCall-to-action button label (default: "Track My Order")
button_colorCTA button background color (hex)

Template Variables

Use {curly_brace} syntax in your subject, heading, and body:

VariableValue
{customer_name}Customer's full name
{order_id}Order ID or order number
{tracking_number}The shipment's tracking number
{tracking_link}URL to the branded tracking page
{courier_name}Carrier display name (e.g. "FedEx")
{shipment_status}Human-readable status label (e.g. "In Transit")
{est_delivery_date}Estimated delivery date if set
{store_name}Your store's display name

Example Subject

Your order {order_id} is on its way!

Example Body

Hi {customer_name},

Great news! Your order {order_id} has been picked up and is currently in transit with {courier_name}.

Tracking Number: {tracking_number}
Estimated Delivery: {est_delivery_date}

Thank you for your order!
{store_name}

Email Design Settings

Beyond templates, you can customize the overall email design:

  • Logo — Upload your store logo (shown in the email header)
  • Logo position — Left, center, or right
  • Show store name — Toggle the text store name in the header
  • Header color — Background color of the email header
  • Email background color — Outer background
  • Card background color — Inner content area background
  • Text color — Main body text color
  • Heading color — Heading text color
  • Dark mode — Enable dark-themed email design

Configure these in Dashboard → Store Settings → Email → Design.

Branding Fields

SettingDescription
branding_nameStore display name shown in the email header
branding_iconSmall icon URL shown in the header
branding_logoFull logo URL shown in the header
sender_emailFrom address for outgoing emails
Social linksFacebook, Instagram, Twitter, etc. shown in footer

Default Templates

If you haven't customized a template, TrackLogy uses built-in defaults. These are fully functional but generic. Customizing them with your brand's voice is strongly recommended.