You can use your own SMTP server to send email notifications instead of using Zuora's default email server. The benefits for using your own SMTP server include:
The following table provides descriptions of the configuration fields and indicates whether they are required. The section that follows this table provides example configurations.
| Field | Required? | Description |
|---|---|---|
| SMTP Server Name | Required | Host name of your SMTP server. |
| SMTP Port | Required | The port that Zuora uses to connect to the SMTP server. |
| SMTP Authentication | Optional | Set to true if the SMTP server requires a user name and password. Default is false. |
| SMTP Enable StartTLS | Optional | Set to true if the SMTP server attempts to upgrade to an encrypted connection (TLS or SSL) before authentication. Default is false. |
| SMTP User Name | Required only if SMTP Authentication is true | Your user name for the SMTP server.
|
| SMTP Password | Required only if SMTP Authentication is true | Your password for the SMTP server. |
| SMTP SocketFactory Port | Required only if you specify the SMTP SocketFactory Class | If specified, Zuora uses this port to send email to the SMTP server. Otherwise, Zuora uses the SMTP Port. |
| SMTP SocketFactory Class | Optional | Set to javax.net.ssl.SSLSocketFactory if the SMTP server uses this class to create SSL sockets. |
| SMTP SocketFactory Fallback | Optional | Set to true if the SMTP server tries to create a socket using a different class if the specified SMTP SocketFactory Class fails. Default is true. |
The following table provides example configurations for some common SMTP email servers.
| Field | Example Configurations | ||||
|---|---|---|---|---|---|
| Gmail | SendGrid | Amazon | SMTP | Office 365 | |
| SMTP Server | smtp.gmail.com | smtp.sendgrid .net | email-smtp .us-east-1 .amazonaws.com | supteam.smtp .com | smtp.office365 .com |
| SMTP Port | 587 | 465 | 465 | 25 | 587 |
| SMTP | true | true | true | true | true |
| SMTP Enable StartTLS | true | true | true | true | true |
| SMTP User | Your Username | Your Username | Your Username | Your Username | Your Username |
| SMTP | Your Password | Your Password | Your Password | Your Password | Your Password |
| SMTP | 587 | 465 | 465 | N/A | N/A |
| SMTP | javax.net.ssl.SSLSocketFactory | javax.net.ssl. SSLSoketFactory | javax.net.ssl. SSLSoketFactory | N/A | N/A |
| SMTP | true | true | false | N/A | N/A |
After entering your SMTP server configuration details and clicking test connection and save, you may get an error message. The following table provides some common error messages and actions you can take to resolve the issue.
| Error Message | Recommended Action |
|---|---|
| Unknown SMTP host | Check that the SMTP Server Name is correct. |
| Could not connect to SMTP host | Check that the SMTP Port is correct. If the port is correct, the SMTP server might be experiencing a temporary issue. Wait a few minutes and try again. |
| Connect timed out | |
| Authentication failed: Bad username / password | Check that your SMTP User Name and SMTP Password are correct. |
| Authentication failed | Check that SMTP Authentication is set to true. If you still get this error message, check that your SMTP User Name and SMTP Password are correct. |
| Authentication required | Check that SMTP Authentication is set to true. |
| Read timed out | Check that you have entered the correct values for the following fields:
|
| Could not convert socket to TLS |
