Configure MODX to Use an Email Service Provider

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)
  1. Login into the MODX Manager where you wish to add an ESP to for email delivery.

  2. Settings Cog

    At the top right of the MODX Manager, click/hover on the cog icon to reveal the menu.

  3. Click on System Settings

    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.

  4. Enter SMTP into the Search by key field.

    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.

  5. 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:

    SMTP settings in MODX using Mandrill as an example.

See the screenshots below for some of the more popular ESPs’ settings.

Mandrill (requires paid MailChimp account)

https://mandrill.zendesk.com/hc/en-us/sections/200775287-SMTP-Basics

Mandrill SMTP credentials view.

SendGrid

https://sendgrid.com/docs/Integrate/index.html

Sendgrid SMTP credentials view.

Postmark

https://postmarkapp.com/developer/user-guide/sending-email/sending-with-smtp

Postmark SMTP credentials view.

Mailgun

https://help.mailgun.com/hc/en-us/articles/203380100-Where-can-I-find-my-API-key-and-SMTP-credentials-

Mailgun SMTP credentials view.

Amazon SES

http://docs.aws.amazon.com/ses/latest/DeveloperGuide/send-email-smtp-software-package.html

amazon_ses_smtp_modx.png

 

Mailjet

 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

Mailjet SMTP credentials view.

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.