WHMCS is the billing and automation system most hosting companies use. Linked to your WHM reseller account, it creates cPanel accounts when customers pay, suspends them when invoices are overdue and terminates them after cancellation, so you spend your time on sales, not admin. The top MdmHost Master Reseller plan includes a free WHMCS licence.
Before you start
- A working WHMCS installation with a valid licence.
- Your WHM reseller username and server hostname.
- At least one WHM package for each plan you sell (see creating packages).
Create an API token in WHM
API tokens are safer than storing your password in WHMCS.
- Log in to WHM.
- Go to WHM → Development → Manage API Tokens.
- Click Generate Token, name it
whmcs, and leave Everything selected or choose the account, package and DNS privileges WHMCS needs. - Click Save and copy the token. It is only shown once.
Add the server in WHMCS
- In WHMCS, go to System Settings → Servers and click Add New Server.
- Choose the cPanel module, enter the server hostname, your reseller username and the API token.
- Click Test Connection. You should see a success message.
- Fill in the nameservers (your private nameservers if you use them) and save.
Create products mapped to packages
- In WHMCS, go to System Settings → Products/Services and create a product of type Shared Hosting.
- On the Module Settings tab, choose cPanel and select the WHM package name, for example
youruser_starter. - Choose Automatically setup the product as soon as the first payment is received.
- Set pricing and save.
Tip: Keep WHM package names stable. If you rename a package in WHM, update the product's Module Settings, or new orders fail with "package not found".
Automation settings
In System Settings → Automation Settings, set how many days after the due date accounts are suspended and terminated. WHMCS then runs the same actions you would do by hand in Manage Account Suspension and Terminate an Account.
Make sure the WHMCS cron job runs every five minutes, or automation does not happen.
Test an order
- Place a test order on your WHMCS client area and mark the invoice paid.
- Check that the account appears in WHM → List Accounts with the right package.
- Open the client's service in WHMCS and use Login to cPanel to confirm single sign-on works.
Troubleshooting
"Access denied" on Test Connection
The token or username is wrong, or WHMCS connects to the wrong hostname. Use the server hostname from your welcome email.
Accounts are created but over your allocation
WHMCS does not know your reseller limits. Check them before launching new plans (see reseller limits).
Frequently asked questions
Can I import existing WHM accounts into WHMCS?
Yes. WHMCS has a Server Sync tool under Utilities → Tools that imports accounts and links them to clients and products.
Does WHMCS need my WHM password?
No. Use an API token. You can revoke the token at any time in Manage API Tokens without changing your password.
Do I need my own WHMCS licence?
WHMCS requires a licence. The top VIP Master Reseller plan includes one; on other plans you buy it separately.