Email Setup

Overview

To send emails from a Mendix app you will need access to an SMTP (Simple Mail Transfer Protocol) email server. If you don't have your own email server, you can request to use one we have set up in Amazon Web Services (AWS) with the AWS Simple Email Service (SES) and an Identity and Access Management (IAM) account associated with the email address. If you have your own email server you can skip to step 3. We recommend using the Mendix "Email module with templates" module which simplifies sending formatted emails. See the Mendix documentation here.

1. Register a "from" email address with the AWS SES email server
2. Get a username and password from AWS IAM to use the email server
3. Configure email settings in Mendix

To minimize the number of accounts the Mendix developer team in OIT create and manage, our policy is to create one account per department. We can link any number of email addresses to that account. If your department already has an account that has been created for Mendix, you can ask the team to look up the user name and password.

1. Register a "from" email address with the AWS SES email server

Ask one of the BYU OIT Mendix developers to register the "from" email address you provide.

2. Get a username and password from AWS IAM to use the email server

Ask one of the BYU OIT Mendix developers to create an AWS IAM user with access to our AWS email server. You will be provided with a user name and password. We can associate many email addresses to the same IAM account so you can use the same user name and password for different "from" addresses in your department.

3. Configure email settings in Mendix

If you have installed the Mendix "Email with templates" module, navigate to Email Templates in your app and enter the following settings in Configuration:

1. Server: email-smtp.us-east-1.amazonaws.com
2. Use TLS (not SSL)
3. Port: 587
4. Use SSL check server identity: No
5. User name: (the one for the AWS SES server from Step 2 above)
6. Password: (the one for the AWS SES server from Step 2 above)
7. From address: (the "from" address you registered with the AWS SES server from Step 1 above)

If you have a different email server that you will use instead of the AWS SES server we have set up, enter those settings instead. If you can't get it to work, we can create an account for you on our AWS SES server.

Save your settings. It should look like this:

You can send a test email to verify that it works. Select the Test button and set the To address to your own email address then click Submit.

You should see the following message if it succeeded and you should see the email from the "from" address you set up.