Add an SMTP Server

This is the Add icon.

Before any email alerts can be sent, at least one Simple Mail Transfer Protocol (SMTP) Server must be configured. Generally, only one SMTP server is required, but this will depend on how (and perhaps to whom) you want to send alerts. If you, for example, want to send alerts to both internal and external recipients, you may also want these to be routed through different servers. In this case, you would need more than one SMTP server.

*If you don’t currently have access to an SMTP server, you might try mailgun (which is easy to set up and inexpensive to use).

1. Click the Add SMTP Server button in the top-right corner of the Notifications screen. A New SMTP Server screen will open.

2. First, enter a name for the new SMTP Server.
3. Then enter the address for the new server. (Example: smtp.mailgun.org) If you don’t specify a port number in the address, the system will use default port number 587.
4. Mark the Enable TLS checkbox if you need to add Transport Layer Security. (In order to use TLS, the SMTP Server you are adding must support a secure connection.)
5. Next, enter the credentials that allow you to use the selected mail server (SMTP username and password).
6. If you need to add custom settings for the SMTP server, click the down arrow to access the Custom Settings (Advanced) fields.
   1. Use the Key field and the Value field to enter necessary info.
   2. Click the + icon to finalize the custom setting.
   3. Click the Trashcan icon to delete a custom setting.

*These custom settings are being made available in the unlikely event they will be needed. If you’d like to learn more about these custom settings, please reference this public resource: https://javaee.github.io/javamail/docs/api/com/sun/mail/smtp/package-summary.html

7. If you want to verify the SMTP server, click the Send Test Email button.
   1. Enter the email address for the test message, then click the Send button.
8. Once all the settings have been entered, click the Save SMTP Settings button to save the server.