WHMCS cPanel integration is what turns WHMCS from a billing system into a hosting business that runs itself. Once the two are connected, a customer can order a plan, pay for it and get a working cPanel account with login details in their inbox, without you touching a thing. This guide walks through the whole setup, step by step, the same way we’d do it for one of our own reseller hosting customers.
What You Need Before Your WHMCS cPanel Setup
- A working WHMCS install with an active license and SSL. If you’re still deciding, start with our guide to what WHMCS is and whether you need it.
- WHM access, either a root login on your own server or a reseller account. Both work for a WHMCS cPanel setup.
- At least one hosting package created in WHM, such as “Starter” or “Business.” WHMCS uses these packages to decide what each new account gets.
- Your nameservers, such as ns1.yourbrand.com and ns2.yourbrand.com, so WHMCS can include them in welcome emails.
Step 1: Create an API Token in WHM
WHMCS can log in to WHM with a password, but an API token is safer. A token can be revoked at any time without changing your password, and it can be limited to only the permissions WHMCS needs.
- Log in to WHM and open Development > Manage API Tokens.
- Click Generate Token and give it a clear name, like “whmcs.”
- Copy the token right away. WHM only shows it once.
Treat the token like a password. Paste it straight into WHMCS, and don’t email it or save it in a shared document.
Step 2: Add Your cPanel Server to WHMCS
- In the WHMCS admin area, open System Settings and choose Servers.
- Click Add New Server and choose cPanel as the module.
- Enter your server’s hostname, your WHM username and the API token from Step 1.
- Click Test Connection. If it passes, fill in the server name, your nameservers and the maximum number of accounts, then save.
If the test fails, the usual causes are a typo in the hostname, a token copied with a missing character, or a firewall blocking WHM’s secure port (2087) from the server where WHMCS runs. The official WHMCS guide to creating a cPanel server covers every field in detail.
Step 3: Create a Server Group
On the same Servers page, create a server group and add your new server to it. Products point to a group rather than a single server, so when you add a second server later, WHMCS can spread new accounts across both without you editing every product. It’s a small step that makes your WHMCS cPanel setup much easier to grow.
Step 4: Create a Hosting Product
- Open System Settings > Products/Services. Create a product group first (for example “Shared Hosting”), then click Create a New Product.
- Set the product type to Shared Hosting (or Reseller Hosting), give it a name and set your pricing on the Pricing tab.
- On the Module Settings tab, choose cPanel, select your server group and pick the matching WHM package.
- Choose Automatically setup the product as soon as the first payment is received. This is the setting that makes the whole thing hands-off.
Repeat this for each plan you sell. Each WHMCS product maps to one WHM package, so keep the names matching to avoid mix-ups.
Step 5: Set Up the WHMCS Cron Job
WHMCS cPanel automation depends on the WHMCS cron job. It’s what generates invoices, sends reminders, and suspends and unsuspends accounts on schedule. WHMCS recommends running it every five minutes. In cPanel, open Cron Jobs and add the command shown on your WHMCS automation settings page; it points to the cron.php file in your WHMCS crons folder.
Once the cron is running, it’s worth reviewing your suspension, termination and reminder settings. We cover each one in our guide to WHMCS automation settings.
Step 6: Test Your WHMCS cPanel Connection With a Real Order
Before you announce anything, place a test order yourself:
- Order a plan from your own store using a test client account.
- Mark the invoice paid from the admin area.
- Check that the account appears in WHM with the right package.
- Confirm the welcome email arrived with the correct login and nameservers.
- Try the suspend, unsuspend and terminate buttons on the service, then delete the test account.
If every step works, your WHMCS cPanel connection is ready for real customers.
Common WHMCS cPanel Problems and Fixes
- Accounts aren’t created after payment. Check that the product is set to set up automatically, and look at the module log (under System Logs) for the error WHM sent back.
- “Package not found” errors. The WHM package name in the product doesn’t match WHM exactly. Reseller package names usually start with your reseller username and an underscore.
- Suspensions don’t happen. The cron job isn’t running. Check the last run time on the WHMCS automation status page.
- Single sign-on doesn’t work. Make sure the WHMCS server entry uses the secure connection and that the token hasn’t been revoked.
How It Works Behind the Scenes
The WHMCS cPanel module is a provisioning module: a piece of WHMCS that knows how to create, suspend and terminate accounts on one specific platform. Every control panel or service WHMCS can automate has one. If you sell something WHMCS doesn’t support yet, a custom module can give it the same hands-off setup. Our guide to WHMCS provisioning modules explains how they work.
Frequently Asked Questions
Can I connect WHMCS to a cPanel reseller account?
Yes. Use your reseller WHM username and an API token created from your reseller WHM. WHMCS can then create accounts within your reseller limits. That’s exactly how most of our reseller customers run their hosting businesses.
Should I use a password or an API token?
An API token. It can be revoked without changing your password, and cPanel recommends tokens for connections like this. See cPanel’s guide to managing API tokens in WHM.
Can WHMCS manage more than one cPanel server?
Yes. Add each server and put them in the same server group. WHMCS fills them according to the group’s fill settings.
Need Help With Your WHMCS cPanel Setup?
Our reseller hosting plans come with WHM, and our WHMCS addons work with any standard WHMCS install. If you get stuck connecting the two, get in touch and we’ll help you sort it out.
