---
title: "Academy App"
canonical_url: "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials"
locale: en
meta:
  "og:title": "Academy App"
---

[Go to home](https://academy.laioutr.com/en)

- [Essentials apps](https://academy.laioutr.com/en/bereiche/essentials-apps)

- [Essentials apps](https://academy.laioutr.com/en/leitfaeden/essentials-apps-basics)

- [Sending email with the Mailer essentials app](https://academy.laioutr.com/en/apps/sending-email-mailer-essentials)

# Sending email with the Mailer essentials app

The Mailer essentials app sends the transactional email of a Laioutr project, such as contact requests, order confirmations or the confirmation of receipt from the Legal app. Mail goes out through an SMTP account or services such as SendGrid, Amazon SES or Mailgun.

## Before you start

<dl>

<dt>Plan</dt>
<dd>Any platform licence</dd>

<dt>Role</dt>
<dd>Admin in Cockpit</dd>

<dt>Duration</dt>
<dd>10 min</dd></dl>

### Prerequisites

- Credentials for an SMTP account or email service
- Access to the DNS settings of the sender domain
- A test address

Last reviewed on October 15, 2026

Sends transactional email such as contact requests, order confirmations, password resets and confirmations of receipt. It is built on Nodemailer and delivers through SMTP or SendGrid, Amazon SES, Mailgun or OAuth2.

[Developer documentation](https://docs.laioutr.com/apps/essentials/mailer)

## How it works

1. Collect credentials and sender addressWhere: Email provider · Role: IT or developer · Duration: 15 min
2. Add SPF, DKIM and DMARCWhere: DNS provider · Role: IT or developer · Duration: 30 min
3. Install the MailerWhere: Cockpit, Apps · Role: Admin · Duration: 2 min
4. Enter credentialsWhere: Cockpit, app configuration · Role: Admin · Duration: 10 min
5. Send and check a test emailWhere: Test address inbox · Role: Admin · Duration: 5 min

## Configuration

| Field | Purpose | Where to find it | Required | Per environment |
| --- | --- | --- | --- | --- |
| `Host` | SMTP server hostname, for example smtp.example.com. | Email provider or IT | Yes | No |
| `Port` | Usually 465 (implicit TLS) or 587 (STARTTLS). Port 25 is often blocked. | Email provider | Yes | No |
| `Secure / TLS` | Implicit TLS (true, typical for 465) or STARTTLS (false, typical for 587). | Email provider | Yes | No |
| `Username` | SMTP login, often the full email address. | Email account | Yes | No |
| `Password` | SMTP password or, for Gmail and Microsoft 365, a dedicated app password. | Email account, security settings | Yes | No |
| `From address` | Default sender address, such as noreply@yourdomain.com. Must be allowed to send through the account. | Team decision | Yes | No |
| `From name` | Optional display name shown next to the sender address. | Team decision | No | No |
| `Reply-To address` | Optional address that replies go to, such as support@yourdomain.com. | Team decision | No | No |
| `SendGrid API key` | Access when SendGrid is used instead of SMTP. | SendGrid account | No | No |
| `Amazon SES access key, secret, region` | Access when Amazon SES is used instead of SMTP. | AWS account | No | No |
| `Mailgun API key and sending domain` | Access when Mailgun is used instead of SMTP. | Mailgun account | No | No |
| `OAuth2 client ID, client secret, refresh token, user` | Access for Microsoft 365 or Google Workspace through OAuth2. | Microsoft 365 or Google Workspace admin console | No | No |
| `Test recipient` | Address that receives a test message during setup. | Team decision | Yes | No |

## Common errors

<dl>

<dt>Login to the SMTP server fails.</dt>
<dd>**Cause:** The regular account password was used, but the provider requires an app password.</dd>
<dd>**Fix:** Generate an app password in the account security settings and enter it.</dd>

<dt>The connection drops or times out.</dt>
<dd>**Cause:** Port and TLS setting do not match, or port 25 is blocked.</dd>
<dd>**Fix:** Use port 465 with secure true or port 587 with secure false.</dd>

<dt>Mail lands in the spam folder.</dt>
<dd>**Cause:** SPF, DKIM or DMARC are missing for the sender domain.</dd>
<dd>**Fix:** Add the records at the DNS provider and check the header of the test email.</dd>

<dt>Only certain recipients receive mail.</dt>
<dd>**Cause:** The account runs in sandbox mode, for example with Amazon SES, and only reaches verified addresses.</dd>
<dd>**Fix:** Request production access from the provider.</dd></dl>

The **Mailer** is the essentials app for sending email from the frontend. Typical cases are contact forms, order confirmations, password resets and the confirmation of receipt for revocations through the Legal app.

It is built on Nodemailer, so practically any delivery route works: in most cases an **SMTP** account, alternatively SendGrid, Amazon SES, Mailgun, or Microsoft 365 and Google Workspace through OAuth2. HTML and plain-text bodies, attachments and DKIM signing are supported.

### Deliverability

For mail to reach the inbox instead of spam, the sender domain needs **SPF**, **DKIM** and, for production, a **DMARC** policy. The team sets these records at the DNS provider, not in the app.

The Mailer covers technical sending. Newsletters, templates in Studio and further channels such as SMS and WhatsApp come with Notifyr.

## Step by step

1. 1 ### Step 1: Collect credentials

   Gather host, port, TLS setting, username, password and sender address of the SMTP account. For Gmail or Microsoft 365, generate a dedicated app password.
2. 2 ### Step 2: Prepare DNS

   Add SPF and DKIM for the sender domain at the DNS provider and create a DMARC policy.
3. 3 ### Step 3: Install the Mailer

   Open **Apps** in Cockpit, choose the **Mailer** essentials app and select **Install**.
4. 4 ### Step 4: Enter access details

   Enter the collected details in the app configuration. Include the provider's sending limits and whether the account is sandbox or production.
5. 5 ### Step 5: Send a test email

   Send a test message to the test address and check both the inbox and the spam folder.
6. 6 ### Step 6: Connect use cases

   Contact forms and the Legal app then use the Mailer for delivery. Test one run per use case.

## Check the result

The test email arrives in the inbox, shows the correct sender name and reply address, and the mail header shows SPF and DKIM as pass.

## Frequently asked questions

Which port is the right one?

Usually 465 with implicit TLS or 587 with STARTTLS. The TLS setting has to match the port. Port 25 is often blocked.

Why does the regular account password not work?

Providers such as Gmail or Microsoft 365 require a dedicated app password for applications. Generate it in the security settings of the account and enter it in the Mailer.

Can an email service be used instead of SMTP?

Yes. SendGrid, Amazon SES, Mailgun, and Microsoft 365 or Google Workspace through OAuth2 are supported.

When is the Mailer enough and when is Notifyr needed?

The Mailer sends transactional email. Newsletters, templates in Studio and channels such as SMS and WhatsApp are what Notifyr is for.

## Related

- [Protect forms from bots and spam](https://academy.laioutr.com/en/artikel/protect-forms-from-bots-and-spam)7 min

  Bot protection checks selected storefront actions such as a newsletter sign-up or a login before they run. A bot protection app is installed for this and the actions to protect are listed in the project configuration.
- [Find, install and configure apps](https://academy.laioutr.com/en/artikel/find-install-and-configure-apps)6 min

  Apps are listed in the Cockpit catalogue under Apps, installed per environment and set up under Configuration. The storefront uses them from the next deployment onwards.
- [Set up the revocation button with the Legal essentials app](https://academy.laioutr.com/en/apps/set-up-the-revocation-button-with-the-legal-essentials-app)8 min

  The Legal essentials app provides building blocks for legally required content, first of all the revocation button under EU Directive 2023/2673 with a two-step flow and an automatic confirmation of receipt. Placement, wording and data sources are set up in Studio.

## Learn it in a lesson

- [Forms, e-mails and consent](https://academy.laioutr.com/en/lektionen/frontend-manager-mailer-and-consentr)9 min

## [Essentials apps](https://academy.laioutr.com/en/leitfaeden/essentials-apps-basics)

Search this guide

1. [Essentials apps: core functions from Laioutr, installed as needed](https://academy.laioutr.com/en/artikel/essentials-apps-core-functions-as-needed)4 min
2. [Set up the revocation button with the Legal essentials app](https://academy.laioutr.com/en/apps/set-up-the-revocation-button-with-the-legal-essentials-app)8 min
3. [Sending email with the Mailer essentials app](https://academy.laioutr.com/en/apps/sending-email-mailer-essentials)10 min

## Structured Data

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://academy.laioutr.com/#website",
      "@type": "WebSite",
      "inLanguage": "en",
      "name": "Default",
      "url": "https://academy.laioutr.com/",
      "translationOfWork": {
        "@id": "https://academy.laioutr.com/#website"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#webpage",
      "name": "Academy App",
      "url": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials",
      "@type": [
        "WebPage",
        "FAQPage"
      ],
      "breadcrumb": {
        "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#breadcrumb"
      },
      "isPartOf": {
        "@id": "https://academy.laioutr.com/#website"
      },
      "mainEntity": [
        {
          "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/1"
        },
        {
          "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/2"
        },
        {
          "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/3"
        },
        {
          "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/4"
        }
      ],
      "potentialAction": [
        {
          "@type": "ReadAction",
          "target": [
            "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials"
          ]
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#breadcrumb",
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "name": "Home",
          "item": "https://academy.laioutr.com/en",
          "position": 1
        },
        {
          "@type": "ListItem",
          "name": "Essentials apps",
          "item": "https://academy.laioutr.com/en/bereiche/essentials-apps",
          "position": 2
        },
        {
          "@type": "ListItem",
          "name": "Essentials apps",
          "item": "https://academy.laioutr.com/en/leitfaeden/essentials-apps-basics",
          "position": 3
        },
        {
          "@type": "ListItem",
          "name": "Sending email with the Mailer essentials app",
          "item": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials",
          "position": 4
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/1",
      "@type": "Question",
      "inLanguage": "en",
      "name": "Which port is the right one?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Usually 465 with implicit TLS or 587 with STARTTLS. The TLS setting has to match the port. Port 25 is often blocked.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/2",
      "@type": "Question",
      "inLanguage": "en",
      "name": "Why does the regular account password not work?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Providers such as Gmail or Microsoft 365 require a dedicated app password for applications. Generate it in the security settings of the account and enter it in the Mailer.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/3",
      "@type": "Question",
      "inLanguage": "en",
      "name": "Can an email service be used instead of SMTP?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Yes. SendGrid, Amazon SES, Mailgun, and Microsoft 365 or Google Workspace through OAuth2 are supported.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/en/apps/sending-email-mailer-essentials#/schema/question/4",
      "@type": "Question",
      "inLanguage": "en",
      "name": "When is the Mailer enough and when is Notifyr needed?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>The Mailer sends transactional email. Newsletters, templates in Studio and channels such as SMS and WhatsApp are what Notifyr is for.</p>"
      }
    }
  ]
}
```