Use SMTP for System Mail

You can choose from several supported mail providers to handle mail for your WHMCS installation. Make sure to choose the mail provider that offers the best service and security features for you. When you configure WHMCS to use SMTP as the mail provider, you can either use the steps below or perform the steps to use Google or Microsoft® to use our OAuth support.

Your mail provider configuration is separate from any email piping or importing that you configure for your support departments. For more information, see Email Piping and Email Importing.

Set Up SMTP as your Mail Provider

To configure the mail provider:

  1. In the Admin Area, go to the Mail tab at Configuration () > System Settings > General Settings.
    The Mail tab in General Settings
  2. Next to Mail Provider, click Configure Mail Provider.
    Configure Mail Provider in the Mail tab
  3. Configure the SMTP settings that you received from your hosting provider or email provider.
    • The port varies depending on the SSL type and your mail server configuration. Check with your mail server administrator for the appropriate port to use. These are the most commonly-used ports by SSL type:
      • None: 25 or 26
      • SSL: 465 or 587
      • TLS: 587
    • Make certain that you enter SMTP Port and SMTP SSL Type correctly. Incorrect settings can prevent WHMCS from sending mail.
      For steps to create an SMTP account in cPanel, see Create an SMTP Account below.
  4. Click Test Configuration at the bottom left of the window to make sure that you entered everything correctly.
  5. When you see a success message, click Save Changes.

Create an SMTP Account

You can create an SMTP account in cPanel and use it to configure your mail provider in WHMCS.

To create an SMTP email account using the cPanel control panel:

  1. Log in to your cPanel account.
  2. Go to Home » Email » Email Accounts.
  3. Click Create.
  4. Enter the desired configuration for the new email account.
  5. Find the new address in the list of email accounts.
  6. Click Manage and then click Connect Devices in the right-side column.
  7. Copy the information under Mail Client Manual Settings. You will use these details to configure the SMTP email account in WHMCS.
    We recommend using the Secure SSL/TLS Settings.
    Secure SSL/TLS Settings

Last modified: June 14, 2024