Guides & TutorialsSystem Settings MailConfiguring WHMCS to use SMTP for WHMCS 8+

Configuring WHMCS to use SMTP for WHMCS 8+

WHMCS comes with the ability to send emails out of the box, without any additional configuration, using PHP mail(). While this works in most cases, other mail providers may give you a better experience. For information about other mail providers available in WHMCS 8.0 and later, see

One of these methods is SMTP

First, navigate to Configuration > System Settings > General Settings > Mail.

Next to Mail Provider, click Configure Mail Provider.

In the new window, specify the SMTP settings that you got from your hosting or email provider. Pay special attention to the SMTP Port and SMTP SSL Type settings. Incorrect settings will prevent mail from sending in WHMCS.

Click Test Configuration at the bottom to make sure that you entered everything correctly. 

Once you see a success message, click Save Changes. WHMCS will now use SMTP to send mail.

Creating a SMTP Account in cPanel to use for Mail

First, log in to your cPanel account and navigate to Home >> Email >> Email Accounts.

Create a new email account by clicking Create and filling out the form appropriately. 

Once you have successfully created the new email account, you should see it in the list of Email Accounts. Within this list, click Manage, and then click Connect Devices in the right-side column.

On the next page, you will see all of your information under the Mail Client Manual Settings heading. In this example, we will follow the settings in Secure SSL/TLS Settings (Recommended).

These are the settings we used to configure the SMTP settings in WHMCS:

Troubleshooting SMTP Issues

For additional help troubleshooting SMTP settings, see Troubleshooting Email Sending Problems.