> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/docs/platform/extensibility/events-and-notifications/configure-email-settings/configure-external-smtp-server/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# Configure external SMTP server

> Learn how to configure external SMTP server to send email notifications.

Learn how to configure external SMTP server to send email notifications.

* Ensure that your SMTP server relay feature is turned on. Otherwise, any emails sent with a mail.from address in the notification that is different from your SMTP server default will fail.
* If you use the Gmail SMTP server, you might need to generate an application-specific password for your account. Otherwise, you will get an error against the invalid password.

Navigate to **Events notifications entry** in the left navigation menu.

Click the **Settings** tab.

In the **Email Settings** section, click the **External SMTP** tab and then click **Edit**.

Configure the required fields.

<table>
  <tr>
    <th>
      Field
    </th>

    <th>
      Required?
    </th>

    <th>
      Description
    </th>
  </tr>

  <tr>
    <td>
      SMTP Server Name
    </td>

    <td>
      Required
    </td>

    <td>
      Host name of your SMTP server.
    </td>
  </tr>

  <tr>
    <td>
      SMTP Port
    </td>

    <td>
      Required
    </td>

    <td>
      The port that Zuora uses to connect to the SMTP server.
    </td>
  </tr>

  <tr>
    <td>
      Authentication
    </td>

    <td>
      Required
    </td>

    <td>
      The authentication scheme for the SMTP server. The following schemes are available:

      * Username/Password
      * OAuth 2.0
    </td>
  </tr>

  <tr>
    <td>
      SMTP Enable StartTLS
    </td>

    <td>
      Optional
    </td>

    <td>
      Set to **true** if the SMTP server attempts to upgrade to an encrypted connection (TLS or SSL) before authentication.

      Default is **false**.
    </td>
  </tr>

  <tr>
    <td>
      SMTP User Name
    </td>

    <td>
      Required
    </td>

    <td>
      The email address of the sender.
    </td>
  </tr>

  <tr>
    <td>
      Password
    </td>

    <td>
      Required only if **Authentication** is set to **Username/Password**
    </td>

    <td>
      Your password for the SMTP server.
    </td>
  </tr>

  <tr>
    <td>
      OAuth2.0 Provider
    </td>

    <td>
      Required only if **Authentication** is set to **OAuth 2.0**
    </td>

    <td>
      The OAuth 2.0 provider you created in **Admin settings oauth provider**.

      To create a new OAuth 2.0 provider, see [Add an OAuth 2.0 provider](/docs/platform/security-and-identity/administrator-settings/add-oauth-2-0-provider) for more information.
    </td>
  </tr>

  <tr>
    <td>
      SMTP SocketFactory Port
    </td>

    <td>
      Required only if you specify the SMTP SocketFactory Class
    </td>

    <td>
      If specified, Zuora uses this port to send email to the SMTP server. Otherwise, Zuora uses the SMTP Port.
    </td>
  </tr>

  <tr>
    <td>
      SMTP SocketFactory Class
    </td>

    <td>
      Optional
    </td>

    <td>
      Set to **javax.net.ssl.SSLSocketFactory** if the SMTP server uses this class to create SSL sockets.
    </td>
  </tr>

  <tr>
    <td>
      SMTP SocketFactory Fallback
    </td>

    <td>
      Optional
    </td>

    <td>
      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**.
    </td>
  </tr>
</table>

Click **Test Connection And Save** when the fields are complete. The data is saved if the connection is successful. If an error occurs, the configuration information is not valid and an error message appears. For more information about error messages and resolutions, see [Common error messages and actions](/docs/platform/extensibility/events-and-notifications/configure-email-settings/configure-external-smtp-server/common-error-messages-and-actions-for-external-smtp-server).

Select the **Select External SMTP Server** checkbox.

> Learn how to configure external SMTP server to send email notifications.

## Docs

- [Common error messages and actions for external SMTP server](https://zuora.ferndocs.com/docs/platform/extensibility/events-and-notifications/configure-email-settings/configure-external-smtp-server/common-error-messages-and-actions-for-external-smtp-server.md): Use this reference to troubleshoot errors when configuring an external SMTP server.