Connecting a cPanel Server to WHMAZ

Connecting a control panel server is what turns WHMAZ from a record-keeping system into an automation system: once it is done, paid orders create real hosting accounts without anyone touching WHM.

1. Create an API token in WHM

  1. Log in to WHM as root or a reseller with account creation rights.
  2. Go to Development → Manage API Tokens and click Generate Token.
  3. Give it a clear name such as whmaz-provisioning.
  4. Grant the privileges needed to create, suspend, unsuspend and terminate accounts.
  5. Copy the token immediately — WHM will not show it again.

2. Add the server in WHMAZ

  1. In the admin portal go to Settings → Servers and click Add Server.
  2. Hostname — the server's fully qualified hostname, not a domain you host on it.
  3. Type — cPanel/WHM.
  4. Username — usually root, or your reseller username.
  5. API token — paste the token from step 1.
  6. Port2087 for WHM over HTTPS.
  7. Add your nameservers, then Test Connection before saving.

3. Point a package at the server

Edit a hosting package and select this server plus the matching WHM package name. Place a small test order and confirm the account appears in WHM.

Common connection problems

  • Connection refused — port 2087 is closed. Allow your WHMAZ server's IP through the firewall.
  • Access denied — the token lacks account creation privileges, or was truncated when pasted.
  • SSL errors — the WHM hostname has an invalid certificate. Fix the certificate rather than disabling verification.
Was this article helpful?