Upgrading a License

Overview

This document explains how to upgrade a Business Email license in Manage2 for cPanel partners, or in Key Administrator (KA) Partner Central for Plesk partners. You can upgrade a license in either the Manage2 or KA Partner Central interfaces, or using the Manage2 or KA API functions.

Important:
  • Business Email does not support downgrades. You cannot downgrade to a lower plan or number of mailboxes.
  • KA clears the custom plan name when you change the plan. You cannot set it again on an existing license in KA Partner Central or through the KA Partner API. When you change the plan, the customer interface shows the Business Email plan name.
  • A Manage2 Business Email license can have a maximum of 1000 mailboxes.

Upgrade a Business Email license

You can upgrade a Business Email license to a higher plan, increase its number of mailboxes, or do both. The license keeps the same licenseID or keyId after an upgrade.

Upgrade a Business Email license in Manage2

To upgrade a Business Email license in the Manage2 interface, perform the following steps:

  1. Log in to your Manage2 account with your WebPros Account credentials.
  2. Go to Licenses » List Licenses.
  3. Click the licenseID value for the Business Email license you want to upgrade.
  4. To change the number of mailboxes, enter the new number in the Mailboxes text box.
  5. To change the Business Email package, select the new package from the Package menu.
  6. Click Update to save the changes.

Upgrade a Business Email license via the Manage2 API

You can use the Manage2 Change a License Package API function to upgrade a Business Email license. To do this, log in to your Manage2 account with your WebPros Account credentials. Then, call the function with the relevant parameters:

  • liscid — The licenseID of the license. This parameter is required.
  • newpackageid — The ID of the package for the license. This parameter is required. If you change only the number of mailboxes, enter the current package ID.
  • mailboxes — The number of mailboxes for the license. This parameter is optional. If you omit it, the number of mailboxes does not change.

For example, to change only the number of mailboxes for the Business Email Starter license with a licenseID value of 99010357, copy and paste the following URL into your browser:

https://manage2.cpanel.net/XMLpackageUpdate.cgi?liscid=99010357&newpackageid=999998259&mailboxes=5

To change only the plan to Business Email Professional, copy and paste the following URL into your browser:

https://manage2.cpanel.net/XMLpackageUpdate.cgi?liscid=99010357&newpackageid=999998263

To change the plan to Business Email Enterprise and the number of mailboxes to seven, copy and paste the following URL into your browser:

https://manage2.cpanel.net/XMLpackageUpdate.cgi?liscid=99010357&newpackageid=999998267&mailboxes=7
Important:

The XMLpackageUpdate.cgi API function uses the liscid parameter for the licenseID identifier.

Upgrade a Business Email license in KA

To upgrade a Business Email license in the KA Partner Central interface, perform the following steps:

  1. Log in to your KA Partner Central account.
  2. Click Manage Licenses.
  3. Click Active Licenses.
  4. Click the Business Email license number that you want to upgrade.
  5. Click Upgrade.
  6. To change the number of mailboxes, enter a new value in the Number of mailboxes text box. The value must be greater than or equal to the current number of mailboxes.
  7. To change the plan, click the upgrade key icon (upgrade key icon), then click the full cart icon (full cart icon) for the plan that you want. KA only offers higher plans.
  8. Click Next.
  9. Review the order, select the license-agreement checkbox, then click Confirm.
  10. Optionally, add a note, then click Next.
  11. Click Submit.

Upgrade a Business Email license via the KA API

You can use the KA Business Email API functions to upgrade a Business Email license. To do this, you need your KA Partner API username and password.

To upgrade a Business Email license via the KA API, send a PUT request to the /keys KA API function with the keyId of the license, the upgraded plan, and the number of mailboxes.

Warning:

The request must contain values for both the plan and the number of mailboxes. If you do not include both values, KA removes the unlisted value from the license.

For example, to increase the number of mailboxes to 48 for the Business Email Starter license with a keyId value of 12527601, run the following command, where LOGIN and PASSWORD are your KA Partner API credentials:

curl -X PUT "https://api.central.plesk.com/30/keys/12527601?return-key-state=true" \
  -H "Content-Type: application/json" --basic --user 'LOGIN:PASSWORD' \
  -d '{
    "items": [
      { "item": "WPC-BE-STA-1M" },
      { "item": "WPC-BE-STA-MAILBOXES-1M", "quantity": 48 }
    ]
  }'

To upgrade the same license to Business Email Professional with 98 mailboxes, run the following command, where LOGIN and PASSWORD are your KA login credentials:

curl -X PUT "https://api.central.plesk.com/30/keys/12527601?return-key-state=true" \
  -H "Content-Type: application/json" --basic --user 'LOGIN:PASSWORD' \
  -d '{
    "items": [
      { "item": "WPC-BE-PRO-1M" },
      { "item": "WPC-BE-PRO-MAILBOXES-1M", "quantity": 98 }
    ]
  }'
← Provisioning a License
Suspending or Unsuspending a License →