> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryoto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Email notifications

> Send order and delivery emails from your own domain: connect your mail server over SMTP, write the templates, and preview what the customer receives.

> [!NOTE]
>
> **Where to find it:** Settings → Customer Notifs → Email — [Open in OTO ↗](https://app.tryoto.com/email)

Email is the channel with room in it. Where an SMS buys a link, an email can carry the order, the items, the branding and the link together — and it is the one the customer still has in six months when they need the receipt.

## Two tabs, in order

**Settings → Customer Notifs → Email** carries **Email Settings** and **Email Accounts**. The accounts come first: nothing can be sent until there is an address to send it from.

### Email Accounts — sending as yourself

An account is your own mailbox, connected over SMTP, so the message leaves from your domain rather than a platform’s. The list shows **Email**, **Mail Server (Host)**, **Display Email** and **Display Name**, and new ones are added with **Add Email Account**.

| Field | What it is |
| - | - |
| **Email** · **Password** | The account’s own credentials. |
| **Host** · **Port** | The SMTP server and port — typically 587 for TLS or 465 for SSL. |
| **Use TLS/SSL** | Set to match the server. |
| **Display Email** · **Display Name** | What the customer sees in their inbox. This is the part that decides whether the message reads as yours. |

> [!TIP]
>
> **Deliverability is a domain problem, not a platform one**
>
> Sending from your own domain is what makes a notification look legitimate — and what makes it land. It also means the SPF and DKIM records on that domain are now part of your delivery reliability. Worth checking with whoever runs your DNS before the first run of tracking emails, rather than after.

More than one account can be configured — support for the ones inviting a reply, a no-reply address for the rest.

### Email Settings — one brand at a time

Settings work exactly as they do for [SMS](https://docs.tryoto.com/modules/customer-notification/sms.md): choose a **brand**, choose the **Email Account** it sends from, set a **Status** — *“Turn email notifications ON or OFF for this brand”* — and then switch individual message types on or off beneath.

![The Email Settings screen](https://mintcdn.com/oto/YkJay8Y-1RDv8ciw/images/cn-17-email.png?fit=max\&auto=format\&n=YkJay8Y-1RDv8ciw\&q=85\&s=b862f520e39646efd821ae258767b48f)

Fig. 1 — The preview on the right is the rendered email in an inbox, sender line and all — not a code view.

### The message types

| Category | Message | Triggered when |
| - | - | - |
| **Shipment Tracking** | **Shipment in Transit** | the shipment is moving to the delivery address. |
| **Customers Feedback** | **Rate Your Delivery Experience** | after successful delivery, to collect feedback. |
| **Delivery Updates** | **Delivery Attempt Failed** | the courier couldn’t complete the delivery. |
| **Address Verification** | **Verify Delivery Address** | the address needs confirmation before delivery. |
| **Returns** | **Return Request Created** | the receiver initiates a return request. |

> [!NOTE]
>
> **Email covers fewer events than SMS, deliberately**
>
> SMS carries fourteen types; email carries five. The ones email leaves out — the OTP, the click-and-collect alert, the slot reminder — are the time-critical ones, where a message sitting unread in an inbox is no use.
>
> Email takes the events where the customer benefits from detail and may want to keep the message. That division is worth preserving rather than switching everything on everywhere.

## Writing the email

![Editing an email](https://mintcdn.com/oto/ft-bRlLvOnJkbVoC/images/cn-18-email-edit.png?fit=max\&auto=format\&n=ft-bRlLvOnJkbVoC\&q=85\&s=968174f555689c7ee99f9aebc429b1dd)

Fig. 2 — A full editor, a subject line, the variables listed above it, and per-country delivery down the left — each country with its own switch.

| | |
| - | - |
| **This message will be sent to** | Countries added from a picker, **each with its own on/off toggle**. So a message can be written once and enabled in Saudi Arabia and Türkiye while held back in the UAE. |
| **Subject** | The subject line, per country and per brand. |
| **Message Body** | A rich editor with fonts, sizes, styling, links and images — plus **Import HTML** for bringing in a design your team already has. |

The variables are listed above the editor, in the product’s own words: *“Edit the HTML source code for advanced customization, or personalize your message with the available variables”* — `{{companyName}}`, `{{link}}`, `{{orderNumber}}`, `{{trackingNumber}}`, `{{companyLogo}}`, `{{deliveryCompany}}`, `{{customerName}}`, `{{boxCount}}` and `{{ref1}}`.

> [!TIP]
>
> **Country-level switches are how you stage a rollout**
>
> Turning a new notification on everywhere at once means finding out about the wording problem in five markets simultaneously. Enabling it in one country, watching what comes back, then switching on the next is the same work in a safer order.
>
> It is also how a message that is legally or culturally wrong in one market simply never goes there, without maintaining a separate template.

## What the customer receives

These are designed HTML emails rather than plain text: a branded header, a status line, the headline, the order number, a prominent call to action, then detail cards for the tracking number, the delivery company and the delivery address. They render right-to-left for Arabic without a separate template.

The advantage over SMS is room. An email can show the items, the address and the order value and *then* offer the link, so the customer often does not need to open anything at all. Everything still links back to the same [branded pages](https://docs.tryoto.com/modules/customer-notification/branded-pages.md) the other channels use.

**Send Test Email** delivers the real thing before you turn it on.

> [!NOTE]
>
> **Which channel for which message**
>
> Urgency decides it. **SMS** for anything time-critical — the driver is outside, the code is needed now. **Email** for anything the customer may want to keep or read properly — confirmations, receipts, return instructions. Sending both for the same event is not thoroughness; it is two interruptions for one piece of news.

## Related

* [Branded pages](https://docs.tryoto.com/modules/customer-notification/branded-pages.md) — the pages emails link to.
* [SMS](https://docs.tryoto.com/modules/customer-notification/sms.md) — the same events, faster and shorter.


## Related topics

- [Customer Notification](https://docs.tryoto.com/modules/customer-notification/overview.md)
- [Collaboration & notifications](https://docs.tryoto.com/platform/collaboration-and-notifications.md)
- [SMS notifications](https://docs.tryoto.com/modules/customer-notification/sms.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.