Knowledgebase

How to Connect WHMCS to a cPanel Reseller Account

Article ID: 48
Last updated: 20 Mar, 2025

WHMCS makes it easy to automate web hosting account provisioning with cPanel. This guide will walk you through connecting your WHMCS installation to your cPanel reseller account.

Step 1: Log in to WHMCS

  1. Access your WHMCS admin area by navigating to yourdomain.com/admin.

  2. Enter your admin credentials to log in.

Step 2: Navigate to Server Settings

  1. From the WHMCS dashboard, go to Setup > Products/Services > Servers.

  2. Click Add New Server.

Step 3: Configure Your cPanel Reseller Server

Fill in the following details:

  • Name: Enter a descriptive server name (e.g., "cPanel Reseller").

  • Hostname: Enter your cPanel server's hostname (e.g., server.yourdomain.com).

  • IP Address: Enter the IP address of your cPanel server.

  • Nameservers: Add your server's nameservers (e.g., ns1.yourdomain.com, ns2.yourdomain.com).

Server Details

  • Type: Select cPanel from the dropdown menu.

  • Username: Enter your reseller username.

  • Password: Enter your reseller account password (Recommended: Use API Token instead).

API Token (Recommended)

  1. Log in to WHM on your cPanel server.

  2. Navigate to Development > Manage API Tokens.

  3. Click Generate Token.

  4. Name your token (e.g., "WHMCS Integration").

  5. Select All Access or specify only the required permissions.

  6. Copy the generated token.

  7. Paste the token in the Password field in WHMCS.

Secure Connection

  • Check the SSL Mode box to ensure secure communication with your cPanel server.

  • Port 2087 should be automatically selected for secure WHM connections.

Click Test Connection to verify the connection. If successful, click Save Changes.

Step 4: Create a Server Group

  1. Go to Setup > Products/Services > Servers.

  2. Click the Create New Group button.

  3. Name the group (e.g., "cPanel Hosting").

  4. Assign your newly added cPanel server to this group.

  5. Click Save Changes.

Step 5: Configure a Hosting Package

  1. Go to Setup > Products/Services > Products/Services.

  2. Click Create a New Product.

  3. Select Product Type as Shared Hosting.

  4. Assign it to your previously created Server Group.

  5. Configure the product details:

    • Module Settings Tab: Select cPanel as the module.

    • Set your desired hosting limits, such as disk space, bandwidth, etc.

  6. Click Save Changes.

Step 6: Test Account Creation

  1. Go to Clients in WHMCS.

  2. Add a new client or select an existing one.

  3. Create a new order using your newly created hosting product.

  4. After payment processing, WHMCS will automatically provision the account on your cPanel server.

Troubleshooting Tips

  • Ensure your firewall allows traffic on port 2087.

  • Double-check API token permissions in WHM.

  • Verify that the hostname and IP address are correct in your server settings.

For additional support, refer to WHMCS documentation or contact support at support@nodespace.com.

This article was:  
Report an issue
Article ID: 48
Last updated: 20 Mar, 2025
Views: 4399