Send Email over SMTP

Why use SMTP#

Many applications and frameworks use the Simple Mail Transfer Protocol (SMTP) to send emails directly to other SMTP servers that in turn send the emails onto end user inboxes. In fact, SMTP is used under the hood for almost all emails and was first defined in 1982! So it's safe to say it's a stable and powerful way to send emails.

You may be able to send emails from an existing application by simply changing to our configuration settings below. However, SMTP is a chatty protocol (literally, our SMTP server responds with "Nice to meet you"!) - and as a result it's a slower way to send an email. So if you can, use our HTTPS API to ensure your emails get there quickly.

If you do need to use SMTP (e.g. to migrate an application with making any code changes), read on for instructions.

SMTP Configuration#

Find your application's SMTP configuration settings and use the following options:

OptionSettingDetails
SMTP Serversmtp.ohmysmtp.comSometimes called Host Address or similar
SMTP Port25, 587, or 2525It doesn't matter which one you pick
EncryptionTLS or STARTTLSNo encryption or other options will work but it is not recommended. If this setting is unavailable, that's fine
AuthenticationPLAIN or LOGINYou may only have an option to enable this without any choices, in that case it will work fine
UsernameYour API tokenAPI tokens can be found under the "API Tokens" menu of a each Domain, there is one unique API token for every domain
PasswordYour API tokenAPI tokens can be found under the "API Tokens" menu of a each Domain, there is one unique API token for every domain

That's all you need. You can continue sending emails through your application's standard email interface and emails sent over SMTP will appear on your dashboard.

Tags#

OhMySMTP supports tagging emails for later categorization and analysis in the UI. To do this over SMTP you need to set a Header on the email, using the email software you're using to send the message. The header name should be X-OMS-Tags and the content either a single string or comma separated list of strings, as follows:

X-OMS-Tags: a single tag

or

X-OMS-Tags: tag one, tag two, tag three