Email on Pantheon
Detailed information on outgoing mail and email hosting for your Pantheon Drupal or WordPress site.
Pantheon does not host inboxes for incoming mail. We recommend using an externally hosted email solution, such as Gmail.
For outgoing emails, we recommend integrating a third-party service provider that supports a REST API configuration. You can use an SMTP configuration, but because SMTP requests are associated with dynamic outgoing IPs there can be negative impacts to deliverability. For a detailed comparison between API configurations and SMTP, see this related blog post from SendGrid.
REST API Providers
Here are some popular email services you can use on the platform and their corresponding Drupal or WordPress integration method:
|SendGrid||Drupal | WordPress|
|Mandrill||Drupal | WordPress|
|Mailgun||Drupal | WordPress|
|SparkPost||Drupal | WordPress|
SMTP Providers & Configurations
Customers have successfully used SendGrid, Gmail, Amazon SES, Mandrill, and other externally hosted SMTP based email providers.
Configuring mail to use port 25, 465 or 587 is strongly discouraged because they attract SPAM activities. Here’s a list of popular email providers and the alternate ports which Pantheon recommends:
|Amazon SES||2587 (STARTLS), 2465 (TLSWRAPPER)|
If you do not find your service provider in the table above, check with their support and/or documentation.
Use the following integration methods for Drupal and WordPress to configure an external SMTP service:
The SMTP Authentication Support module for Drupal 8 is currently in Beta, support may be limited.
This is a common error with the SMTP Authentication Support module. It can be fixed in a few steps:
- Copy the file from
- Place in a custom module's includes dir and .info file using
files = includes/filename.inc.
Remove the original file from the
DELETE FROM registry WHERE name='[appropriate-name]' AND module='mailsystem';
terminus drush <site>.<env> -- cc all
See available patch.
Unable to Send Mail with Amazon SES
SES places new users into 'sandbox mode' to help prevent fraud and abuse. If you are having trouble sending mail and are using SES, confirm you are not in sandbox mode. For more information, see AWS documentation on sandbox mode.
Frequently Asked Questions
Can I use Pantheon's local MTA (postfix)?
We strongly recommend that you do not use the local MTA (postfix) as described above. Instead, we recommend using a third-party email service provider.
Can I access the mail logs for my site?
No, mail logs are not available for download and we do not recommend using the local MTA (postfix).
What ports are recommended by Pantheon?
Configuring mail to use port 25, 465 or 587 is strongly discouraged because they attract SPAM activities. Make sure that your service provider allows traffic on a port other than those mentioned and that you have correctly configured your site to use that port.
Can Pantheon provide, publish, or support SPF records?
As consumers of cloud infrastructure, we don’t have control over our IP ranges and they are subject to change without our notice. Publishing an SPF record would imply assurance on our end that it can work, which would be very difficult to guarantee given these circumstances. We take the decision of what we support and what we don’t very seriously, and at this time we’re not in a position to support SPF records.
Why does my Gmail user name and password not work?
Please see Google's help article: My client isn't accepting my username and password.
Can I use Microsoft Exchange or Office 365 for my emails?
Office 365 uses ports
587 by default, and different options for sending via SMTP client, Direct send or SMTP relay. This document outlines the limitations and configurations of each, to know what will work for your application.
Because we don't support SPF, it is likely that most Exchange or Office 365 servers won't work if its configured at your email server. Check your organization's Microsoft Exchange settings on what's allowed by your system.