Skip to content

Adding your cPanel Reseller Account to WHMCS

WHMCS is a popular billing and automation platform used by many web hosting resellers. If you are a cPanel reseller, you can integrate your cPanel Reseller Account with WHMCS to automate the provisioning and management of hosting accounts. This guide will step you through the process of connecting your cPanel reseller account with WHMCS.


You will need a WHMCS license to install WHMCS. Asura Hosting is an official partner with WHMCS and offer WHMCS licenses at discounted rates for all our reseller plans. Heres how to purchase one.


Before you proceed, make sure you have the following:

  1. cPanel Reseller Account: Ensure that you have a cPanel Reseller account. If you don't have a Reseller Hosting account and would like to get one, you can view our reseller plans with cPanel here.

  2. WHMCS Installation: Ensure you have a working WHMCS installation, we also have a guide on Installing WHMCS directly through Softaculous if you still need to install it.

Step 1: Obtain API Credentials

  1. Log in to your cPanel Reseller Account.

  2. Go to the "API Tokens" section in WHM/cPanel. You can usually find this under the "Development" or "API" section.

  3. Generate a new API token by clicking on the "Generate API Token" button.

  4. Provide a name for the token (e.g., WHMCS API Token) and choose the required permissions (e.g., List Accounts, Create Accounts, Suspend Accounts, etc.).

  5. Click the "Generate" button to create the API token. Save the generated token securely as you will need it later.

Step 2: Adding the Reseller account to WHMCS

  1. Log in to your WHMCS admin area.

  2. Go to "System Settings" > "Servers"

  3. Click on the "Add New Server" button.

  4. Fill in the server details:

    • Name: Enter a name for your cPanel Reseller Account (e.g., My cPanel Reseller).
    • Hostname: Enter the hostname or IP address of your cPanel Reseller Account.
    • IP Address: Enter the IP address of your cPanel Reseller Account.
    • Type: Choose "cPanel" from the dropdown.
    • Username: Enter your cPanel Reseller Account username.
    • Password: Enter your cPanel Reseller Account password.
    • Access Hash: Enter the API token you generated in Step 1.
  5. Click the "Test Connection" button to verify the connection to your cPanel Reseller Account.

  6. If the connection test is successful, click the "Save Changes" button to add the server.

Step 3: Create a Server Group

  1. Go to "System Settings" > "Servers"

  2. Click on the "Create New Group" button.

  3. Fill in the group details:

    • Name: Server Group name (e.g. cPanel Servers)
    • Fill Type: We recommend choosing "Add to the least full server"
    • Selected Servers: Select the Reseller account you added in Step 2 and click on the "Add" button

Step 4: Create Product/Service Group and Product

  1. In WHMCS admin area, go to "System Settings" > "Products/Services"

  2. Click on the "Create New Group" button and enter a name for the product/service group (e.g., Shared Hosting).

  3. Now go back to "System Settings" > "Products/Services"

  4. Click on the "Create a New Product" button.

  5. Fill in the product details:

    • Product Type: Choose "Hosting Account."
    • Product Group: Select the group you created in Step 3.
    • Name: Enter a name for the product (e.g., Starter Hosting).
    • Module Settings: Choose the server you added in Step 2 from the dropdown.
    • Pricing: Set the pricing and billing cycle for the product.
  6. Click the "Save Changes" button to create the product.

Step 5: Configurable Options (Optional)

  1. If you want to offer configurable options for your hosting packages (e.g., disk space, bandwidth), you can set them up in WHMCS.

  2. Go to "System Settings" > "Configurable Options"

  3. Click on the "Create New Group" button and enter a name for the options group (e.g., Hosting Resources).

  4. Click on the "Add New Configurable Option" button and configure the options as needed.

  5. Assign the configurable options to the product you created in Step 4.

Step 6: Test the Integration

  1. Create a test order for the product in WHMCS to test the integration.

  2. Complete the order process, and WHMCS should automatically create a new hosting account on your cPanel Reseller Account.

Now, WHMCS will handle the account creation, suspension, and termination processes, streamlining your hosting business operations. 🚀