Mail SMTP Settings and E-Mail configurations
SMTP Setup tells the ERP how to send email. Without it nothing leaves — no invoices to customers, no scheduled reports, no password resets. The page is a guided setup: pick your provider, work through five steps, and run a connection check that tests one stage at a time and says in plain words what is wrong when a stage fails.
Where to find it
Go to Setup > E-Mail & SMTP > SMTP Setup.
The status banner
The top of the page states where you stand, so you never have to guess:
| Banner | Means |
|---|---|
| Email is working | The last check passed. It says when it was checked and which server mail goes out through. |
| Email is not working | The check failed, naming the stage it failed at. |
| Settings saved, but not checked yet | Values are stored; nothing has been proved. |
| Email sending is not set up yet | Nothing has been configured. |
| Testing mode is on | No emails are being delivered. See below. |
It also reports how many of the recently logged emails failed, with a link to the Email Log and the latest error.
Step 1 — Your email provider
Choose your provider from the list. The provider guide then tells you what that provider actually requires, which is usually not what its marketing pages say — a Google App Password rather than the account password, Authenticated SMTP switched on for Microsoft 365, the right region for Zoho, and so on.
Step 2 — Mail server
| Field | Notes |
|---|---|
| Host | The outgoing (SMTP) server of your email account. The server name only, for example smtp.gmail.com. |
| Port | The port. 465 goes with SSL, 587 with TLS. |
| Encryption | SSL or TLS. It must match the port. |
Step 3 — Sign-in
| Field | Notes |
|---|---|
| Username | The account the ERP signs in with to send email. |
| Password | Leave empty to keep the saved password. Type a new one only to change it. |
Step 4 — Sender
Show the sender as decides the name on the message:
| Option | The customer sees |
|---|---|
| The person sending the email | The name of whoever sent it. |
| The company | Your company name. |
| Both — Person · Company | Both together. |
The page shows exactly what the customer will see, and where a reply will go, rather than leaving you to work it out.
The sending address is fixed to the SMTP account. Providers reject, or silently spam-file, mail claiming to come from an address the signed-in account is not allowed to send as — so the address that signs in is the address mail goes out from.
Step 5 — Check and test
| Button | What it does |
|---|---|
| Check connection | Signs in to the mail server and checks every step, without sending an email. |
| Send test email | Checks every step and sends a real test email to an address you give. |
| Save and run the connection check | Saving also runs the check. |
What the connection check tests
The check works through the stages in order and stops at the first failure, so you are given one problem to fix rather than a list to interpret:
| Stage | Answers |
|---|---|
| Settings | Is everything needed filled in? |
| DNS | Does the host name resolve? |
| Port | Can we reach it? |
| Encryption | Does the encryption match what the server offers on that port? |
| Sign-in | Are the username and password accepted? |
| Sender | Will the server let us send as this address? |
| SPF / DMARC | Does your domain authorise this server? This is what decides spam filing. |
One-click fixes
Where the failure has an obvious remedy the check offers it as a button — Use port 587 with TLS, Use smtp.gmail.com. The fix is applied to the form and the check runs again without saving, so you can try a suggestion without committing to it.
Server replies are translated per provider, so a cryptic code becomes the actual cause: an app password that is needed, authenticated SMTP that is switched off, a region that is wrong.
Testing mode
Testing mode stops emails being delivered while everything else behaves normally. Use it while setting up templates or trying a process end to end. The banner says so in as many words, because nothing is more confusing than a system that reports success and sends nothing.
Advanced
| Option | What it does |
|---|---|
| Log the SMTP conversation | Records the exchange with the mail server. Switch on when a failure is not explained by the check; switch off afterwards. |
| Remove SMTP settings | Deletes the saved settings. The ERP cannot send email until they are set up again. |
Email header and footer
Standard content wrapped around every outgoing message — branding and a greeting at the top, contact details and any legal notice at the bottom. Set once here rather than repeated in each template.
If mail is still not arriving
| Symptom | Where to look |
|---|---|
| The check passes but nothing arrives | Testing mode. Then the Email Log. |
| Sends, but arrives in spam | The SPF / DMARC stage of the check. |
| Some send, others fail | Provider sending limits, or invalid recipient addresses. |
| Scheduled reports never arrive | The background job, not SMTP. See Automatic Email Reports. |
Related pages
- Email Templates — the content that gets sent
- Email Log — delivery status and errors
- Automatic Email Reports — scheduled sending
- Company Setup — the BCC address for outgoing mail