Email Service Providers (ESP) improve email deliverability and give you great diagnostic logs when problems arise. ESPs virtually eliminate your mail ending up in spam folders or being blocked by webmail providers.
Some ESPs offer a free tier that allows you to send 1000s or more emails per month, adequate for many sites’ transactional emails like registration confirmations and receipts. Some of the more popular ones include Mandrill (requires paid Mailchimp Account), SendGrid, Postmark, Mailgun, Mailjet and Amazon SES.
You need the following information from your ESP to configure MODX to send email via their service:
- SMTP Server Address
- Username (sometimes the API key)
- Password (often a unique API key)
- Port Number (usually 587)
- Connection or protocol prefix (usually tls)
Login into the MODX Manager where you wish to add an ESP to for email delivery.
At the top right of the MODX Manager, click/hover on the cog icon to reveal the menu.
From the cog menu, click on System Settings and you'll be taken to a page with a grid of various settings and their values.
In the field at the top right of the grid that has the placeholder text of Search by key… enter "SMTP" (without the quotation marks) as this will filter all the settings you need.
Complete the setup of your SMTP settings for your ESP as follows:
- Use SMTP should be set to Yes
- SMTP Port should usually be set to 587, or an alternate port provided by your ESP
- SMTP Connection Prefix should usually be set to
tls, but may vary depending on your ESP
- SMTP Authentication should be set to Yes
- SMTP Password should be set to the password provided by your ESP
- SMTP User should be set to the username provided by your ESP
Here's a screenshot example using the information from Mandrill:
See the screenshots below for some of the more popular ESPs’ settings.
Mandrill (requires paid MailChimp account)
Mailjet may work with 587/tls, but most examples show 465/ssl. https://www.mailjet.com/support/how-can-i-configure-my-smtp-parameters,2.htm