---
title: Configuring a custom SMTP email notification server
description: Use the Senders page to configure your organization's SMTP server.
component: pingone
page_id: pingone:settings:p1_configure_custom_smtp_server
canonical_url: https://docs.pingidentity.com/pingone/settings/p1_configure_custom_smtp_server.html
revdate: March 15, 2026
section_ids:
  steps: Steps
---

# Configuring a custom SMTP email notification server

Use the Senders page to configure your organization's SMTP server.

|   |                                                                                                                                                                                                                                                                         |
| - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|   | When you use a custom SMTP server, PingOne sends email through your organization's mail infrastructure. Your domain's existing Domain-based Message Authentication, Reporting, and Conformance (DMARC) policies apply to all messages sent by PingOne from this server. |

## Steps

1. Go to **Settings > Senders**.

2. Click **+**, enter the following options, and then click **Next**:

   1. In the **Sender Type** list, select **Email**.

   2. In the **Provider Type** list, select **Custom Server**

3. In the Email Sender **Custom SMTP Server** area, enter the relevant details:

   |   |                                                                                                        |
   | - | ------------------------------------------------------------------------------------------------------ |
   |   | Any edit changes on previously saved custom server fields requires re-entry of the **Password** field. |

   | Field                | Type      | Description                                                                                                                                                                                                                    |
   | -------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
   | **Username**         | Mandatory | The organization's SMTP server's username.                                                                                                                                                                                     |
   | **Password**         | Mandatory | The organization's SMTP server's passcode.                                                                                                                                                                                     |
   | **Server Name**      | Mandatory | The name of the organization's SMTP server.                                                                                                                                                                                    |
   | **Port**             | Mandatory | The port used by organization's SMTP server to send emails (default: 465). NOTE: The protocol used depends upon the port specified. If you specify port 25,587, or 2525, SMTP with STARTTLS is used. Otherwise, SMTPS is used. |
   | **From Name**        | Optional  | The name that displays as the sender's name in the email message.                                                                                                                                                              |
   | **From Address**     | Mandatory | The email address that displays as the sender's email address in the email message.                                                                                                                                            |
   | **Reply-To Name**    | Optional  | The name that displays as the sender's reply-to name in the email message.                                                                                                                                                     |
   | **Reply-To Address** | Optional  | The email address that displays as the sender's reply-to address in the email message.                                                                                                                                         |

4. Click **Save**.

   If you haven't yet sent a test email, you might get a warning message indicating that saving SMTP settings without validating credentials using the test email button can cause problems sending emails. You can also send a test email later.

   |   |                                                                                                                                                                  |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | When saving, authentication isn't tested using the new credentials. Follow up with the **Send Test Email** step to confirm successful SMTP server configuration. |

5. To test the SMTP server configuration, edit the Email entry in the **Senders** list and then click **Send Test Email**.

   The **Send Test Email** modal opens.

   ![The Send Test Email modal, showing an option to send a test email message to a specified address.](_images/TestEmailSMTP.png)

6. Enter a recipient email address in **Send to** and click **Send**.

7. Check the destination email box for the test email.

   PingOne returns one of the following status messages:

   * **Success**

     ![A successful status message with the text A test message was successfully sent to some.body at acme.com.](_images/wuh1567784302549.png)

   * **Failure**

     ![A failure status message with the message, Using the credentials you provided, we couldn't authenticate with your email server.](_images/aan1567784303621.png)