Skip to main content

Why aren’t emails being delivered?

Zuora

Why aren’t emails being delivered?

Zuora allows you to email invoices and send a variety of customer notifications from within the Zuora Billing application and Workflow to your end customers. When using the Zuora mail delivery system with a From address of your own domain, you need to specifically authorize the Zuora mail systems to send on the behalf of your domain. Otherwise, some emails might not reach their intended recipients, potentially due to spam and junk filters seeing the emails as phishing.

This can greatly impact your company's ability to collect payment. Customers who do not receive their invoices may not pay their invoices on time, and customers who do not receive notifications regarding their expiring credit cannot provide updated card information.

Solution

To ensure your emails reach the intended recipients, use one of the following approaches. 

Configure Advanced SMTP server in Zuora

The Advanced SMTP solution in Zuora is a no-cost option to sending email securely, globally, and at scale. Powered by Amazon’s Simple Email Service (SES) that has pre-integrated with Zuora, the Advanced SMTP server is a great solution requiring no partnership or integration work from your side.  

All emails sent through Advanced SMTP server are authenticated using DomainKeys Identified Mail (DKIM) authentication mechanism. Authentication is one method to build trust with email providers and can validate legitimacy of emails. When authenticating an email, you must provide evidence that you are the owner of the account and your emails have not been modified in transit. 

Meanwhile, Advanced SMTP complies with Domain-based Message Authentication, Reporting and Conformance (DMARC). DMARC is an email authentication protocol that uses DomainKeys Identified Mail (DKIM) to detect email spoofing, which serves as an additional step to ensure that your emails are identified as trusted by the email providers of your customers.

To prevent your emails from being blocked or sent to spam or junk filters, ensure to add include:amazonses.com to the SPF record in your domain’s DNS settings. This also applies to Workflow email notifications as Workflow also utilizes Amazon SES.

You can leverage the Amazon SES mailbox simulator to test different scenarios, such as email bounces or complaints, without bringing any negative impact on your company. See Mailbox simulator for the Amazon Simple Email Service for more information.

For more information about enabling Advanced SMTP, configuring SPF records, and testing email bounces and complaints, see Configure an SMTP server for email notifications.

Configure an External SMTP server 

You can set up an external SMTP server in Zuora and configure either or both of SPF and DKIM records to send notification emails through your own server or a third-party vendor such as SendGrid.

To configure an external SMTP server in Zuora, see External SMTP server for more information. If you use a third-party SMTP server, you can reach out to the vendor to get the setting details. SendGrid's integration documentation is provided as an example.

Configure SPF record for default email server from Zuora Billing notifications

For Zuora's default email server, ensure that you publish your SPF record in DNS records of type TXT under your domain name (yourcompanyname.com). The terminology used herein is from a DNS context.

An SPF example to authorize Zuora's email server host is as follows:

v=spf1 mx a:zgateway.zuora.com -all

In this example, the only hosts authorized to send emails claiming to be from your domain are Zuora's outbound email servers and the ones listed in your MX records.

You can check the status of your SPF records using an online tool such as MX Toolbox's Supertool.