How to integrate Mautic with Amazon SES

Mautic and Amazon SES are two amazing tools that will help your business grow. Mautic is definitely a game changer when it comes to effective email marketing automation. This article is aimed at those who need some quick guidance on how to configure the Email Settings. First of all, stay assured that you’ve chosen the right tools. It is true that Amazon SES is 100 times cheaper than Mailchimp, but that is not necessarily the most important advantage. AWS are better just because they are reliable, provide transparent/justified pricing and the emails really hit the inbox — the deliverability rate is truly outstanding. I have been using Mandrill from Mailchimp in the past, however, I am getting more business now with Amazon SES, plus my clients get better results. Before going any further make sure you decide on your AWS region. For this tutorial I have chosen Oregon us-west-2.console.aws.amazon.com.

A. Email Verification

1. Log into the AWS console https://aws.amazon.com/console/

2. Click on SES Email Sending Service https://us-west-2.console.aws.amazon.com/ses/

3. I assume that you have already set up your email account: youremail@domain.com. In order to make the things easier, when you set up your email account please make sure you create two separate folders: one folder called Bounces and the second one Complaints. Please do that first — it will save you time.

4. Once you’ve clicked on https://us-west-2.console.aws.amazon.com/ses/ go to Email Addresses.

5. Click on the blue button: Verify a New Email Address — a popup will appear. Fill in with your desired email address: youremail@domain.com and click on the blue button Verify This Email Address. A verification email from AWS should hit your inbox in less than a minute, it might take longer if your email server is slow. Once you get it, click on the verification link and you’re done. I recommend running your Mautic instance on AWS.

B. SMTP Settings

1. Go to https://us-west-2.console.aws.amazon.com/ses/ click on SMTP Settings.

2. Once there, make sure to copy and paste in a word pad the Server Name. Like I have mentioned in the intro, this tutorial is based on the Oregon region: email-smtp.us-west-2.amazonaws.com. The port is 25.

3. In order to obtain your SMTP credentials click on the blue button Create My SMTP Credentials. A new window will appear. Make sure you copy and paste the credentials in a safe place. Alternatively you are given the option to download your credentials as an Excel file.

C. Bounces and Complaints Setup

1. Log into the AWS console https://aws.amazon.com/console/ click on SNS Push Notification Service.

2. Click on Topics, once you get there click on Create new topic, a popup will appear. Within the popup within the Topic name field write “bounces” or “bounces_mybusinessname” — a format which I recommend.

3. Repeat step 2 — instead of bounces write “complaints” or “complaints_mybusinessname”.

4. Within the dashboard you will see the newly created topics.

5. Click on the bounces_mybusinessname, afterwards click on Actions, a drop down menu will appear — click on Subscribe to topic — a popup will appear. Within the popup window leave the Topic ARN field as it is. By default the Protocol is HTTP, click on it, and a drop down menu will appear — select the Email value instead. Within the Endpoint field — enter youremail@domain.com, the same email that you’ve verified at stage A. Email Verification.

6. Repeat step 5 for complaints_mybusinessname.

7. Go to youremail@domain.com. By that time you should have got two emails from AWS — one to confirm the Bounces setup and second for Complaints. Make sure you click on both links and verify the subscriptions.

D. Mautic — Amazon SES Integration

1. Go to your Mautic installation: yourdomain.com/s/config/edit

2. Click on Email Settings. Within the email settings panel you will see 5 main sections: Mail Send Settings, Monitored Inbox Settings, Bounces, Unsubscribe Requests and Message Settings. Make sure you scroll down, you will see all of them.

3. Start with filling out the Mail Send Settings fields: Name to send mail as = Your Desired Name, E-mail address to send mail from = the email you’ve just verified, Custom return path (bounce) address = the email you’ve just verified, Service to send mail through = Other SMTP Server, SMTP host = email-smtp.us-west-2.amazonaws.com (remember that this tutorial is regarded with the Oregon region), SMTP port = 25, SMTP encryption type = TLS, SMTP authentication mode = Login, the Username for the selected mail service and Password for the selected mail service were obtained by you at stage B. SMTP Settings step 3.

4. Before going any further, within the Mail Send Settings section you will see two buttons: Test Connection and Send test email — once you click on them you should get this message: “Success!”. Just in case you get an error it means that you have not followed the right steps entirely.

5. Within the Default Mailbox section Monitored address = the email you’ve verified, IMAP host = mail.yourdomain.com or i.e. sever99.web-hosting.com (please refer to your hosting provider), Port = 993, Encryption = SSL, IMAP username = youremail@domain.com, IMAP password = your password.

6. Within the Mail Send Settings section there is a green button: Test connection and fetch folders, once you click on it you should get this message: “Success!”. Just in case you get an error it means that you have not followed the right steps entirely. Now, do you remember stage A. Email Verification step 3.? I assume you have followed that one because we will need those folders ready for the next steps.

7. Scroll down and go to the Bounces section, the Folder to check field contains a drop down menu, click on it and select the Bounces folder that you have created at stage A. Email Verification step 3., Monitored address = the email you’ve verified, IMAP host = mail.yourdomain.com or i.e. sever99.web-hosting.com (please refer to your hosting provider), Port = 993, Encryption = SSL, IMAP username = youremail@domain.com, IMAP password = your password. Within the Bounces section there is a green button: Test connection and fetch folders, once you click on it you should get this message: “Success!”. Just in case you get an error it means that you have not followed the right steps entirely.

8. Scroll down and go to the Unsubscribe Requests section, the Folder to check field contains a drop down menu, click on it and select the Complaints folder that you have created at stage A. Email Verification step 3., Monitored address = the email you’ve verified, IMAP host = mail.yourdomain.com or i.e sever99.web-hosting.com (please refer to your hosting provider), Port = 993, Encryption = SSL, IMAP username = youremail@domain.com, IMAP password = your password. Within the Unsubscribe Requests section there is a green button: Test connection and fetch folders, once you click on it you should get this message: “Success!”. Just in case you get an error it means that you have not followed the right steps entirely.

9. That’s it folks, click Apply or Save and close and you’re ready to rock! :)

A single golf clap? Or a long standing ovation?

By clapping more or less, you can signal to us which stories really stand out.