By default SimpleAMS only sends transactional platform email (account registration, billing). All workspace email - device acceptance, alert digests, license expiry warnings - goes through your SMTP server. This guide shows the five most common setups.
The seven fields
Wherever you source SMTP credentials, you'll plug seven things into Settings → Integrations → Custom SMTP:
- Host - the SMTP server hostname.
- Port - 587 for STARTTLS, 465 for SSL/TLS, 25 only for plain (don't).
- Encryption -
tls,sslornone. - Username - the account or API key login.
- Password / API key - the secret.
- From address - e.g.
it@acme.com. Must be authorised to send through this server. - From name - the human label shown next to the from-address in clients.
SendGrid
Host: smtp.sendgrid.net
Port: 587
Encryption: tls
Username: apikey
Password: SG.your-key-here
From: it@yourdomain.com (verified single-sender or authenticated domain)
Amazon SES
SES needs a verified domain identity. From your AWS console, generate SMTP credentials (not your normal AWS keys - SES has its own).
Host: email-smtp.eu-west-1.amazonaws.com (region of your choice)
Port: 587
Encryption: tls
Username: AKIAIOSFODNN7EXAMPLE
Password: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Postmark
Host: smtp.postmarkapp.com
Port: 587
Encryption: tls
Username: your-server-token
Password: your-server-token (same value)
Google Workspace SMTP relay
If your domain runs on Google Workspace and you want to keep email "from us" rather than "via SendGrid", set up an SMTP relay service in the Workspace admin console (Apps → Google Workspace → Gmail → Routing → SMTP relay service). Allow your origin IP, then:
Host: smtp-relay.gmail.com
Port: 587
Encryption: tls
Username: relay-account@yourdomain.com
Password: app-password
Microsoft 365 SMTP
Host: smtp.office365.com
Port: 587
Encryption: tls
Username: service-account@yourdomain.onmicrosoft.com
Password: app-password (you need modern authentication + app password)
Verify it works
Easiest path: check out an asset to someone with an email address and tick the Send acceptance email option. Within a few seconds they should receive the device acceptance link, from your domain.
What happens without SMTP configured
If the workspace tries to send mail and the SMTP integration is missing or disabled, SimpleAMS writes the message to the workspace audit log as an audit trail rather than falling back to the platform mailer. You'll see a yellow banner on /notifications nudging you to configure it. The calling action still succeeds - no 500s, no lost data - but the email doesn't actually leave the box.