IoTMail / Docs / Quick start
Quick start

Up and running
in five minutes

From zero to sending a verified email from your IoT device. This guide covers account creation through to your first successful send.

What you need

An IoT device, router, or gateway that supports SMTP AUTH on port 587 or 465 with TLS. That is the only requirement. If your device can send email via a relay, it works with IoTMail.

SMTP settings at a glance:

Host: smtp.iotmail.co.uk
Port: 587 (STARTTLS) or 465 (SMTPS implicit TLS)
Auth: PLAIN or LOGIN
TLS: Required. Minimum TLS 1.2.
Username and password: from your IoTMail portal device page.

Step by step

1
Create your account
Go to portal.iotmail.co.uk/register. Enter your email and a password. No card required. You will receive a verification email immediately.
2
Verify your email
Click the link in the verification email. Your account activates instantly. Check spam if it does not arrive within two minutes.
3
Choose your account handle
Pick a short prefix that identifies your organisation or project. Example: acme or workshop1. This becomes the first part of all your device sender addresses. You cannot change this after setting it, so choose carefully.
4
Add your first device
Click Add Device. Give the device a name and a short identifier tag. Example: name RUT241 Site A, tag gw-001. The portal generates a unique username and password for this device.
5
Copy the credentials
The portal shows the full SMTP settings for your device. Copy them. The password is shown once - if you lose it, generate a new one from the portal. The old one is immediately revoked.
6
Enter the settings into your device
In your device firmware or web interface, find the SMTP or email configuration. Enter the settings below.
Your device SMTP configuration
SMTP host:     smtp.iotmail.co.uk
Port:          587              # STARTTLS. Use 465 for implicit TLS.
TLS:           Required         # Do not use plaintext.
Username:      acme+gw-001      # Your handle + device tag
Password:      ****             # From portal device page
From address:  acme+gw-001@iotmail.co.uk  # Must match username exactly
To address:    alerts@yourdomain.com      # Where alerts should go
7
Send a test email
Use your device's test send function. You should receive the email within a few seconds. If it fails, check the username and From address match exactly.
8
Check the portal send log
Log in to the portal and go to Send Logs. Your test send should appear with a delivery status. Green means delivered. Any error shows the SMTP rejection reason.
The most common mistake: The From address in the email must match the SMTP username exactly - including the domain. If your username is acme+gw-001 then the From address must be acme+gw-001@iotmail.co.uk. IoTMail enforces this binding on every message. A mismatch causes a 550 rejection.

Next steps

Device guide
Teltonika setup
Device guide
Milesight setup
Device guide
Sierra Wireless setup
Device guide
Robustel setup