> ## Documentation Index
> Fetch the complete documentation index at: https://docs.upmind.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Link a WHM Account to Upmind

> Manage reseller account with Upmind.

This article shows resellers how to link a WHM account to an Upmind account. After linking accounts, the next step is to create a hosting package on Upmind. That is where you name the package, configure details, and set billing terms.

We describe hosting package details in a different article. [Learn more](/guides-for-web-hosting-accounts/create-a-hosting-package).

## Adding a new provision

The first step is to configure a new provision. This is how you add web servers and domain providers via APIs.

1. Log in to your Upmind account.
2. Go to **Settings** > **Provision Configurations**.

<Frame caption="Settings > Provision Configurations">
  <img src="https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=cafcb7c5b34efe0b34a0f44e329b2568" alt="Settings > Provision Configurations" className="mx-auto" style={{ width:"99%" }} data-og-width="2848" width="2848" data-og-height="1276" height="1276" data-path="images/fb/9914a06211eeda52.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=280&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=cbaa603ee12c40441fb355a7825479f9 280w, https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=560&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=9709521a2db2fc8be20d7174ec89c840 560w, https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=840&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=713095407e7d85fa33c767f0d54fe327 840w, https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=1100&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=fbc96c8fc1e37da2d03820b411728d6a 1100w, https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=1650&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=82bde5769cd1fef852d9f615c5797116 1650w, https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/9914a06211eeda52.png?w=2500&fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=e3c07e37903938b7fe692779a4e823ff 2500w" />
</Frame>

3. Click the **Add new configuration** button to add a WHM server account. A new panel displays.

The screenshot below shows two active services (domain hosting and web hosting).

<Frame caption="Add new configuration">
  <img src="https://mintcdn.com/upmind/uxzVUXAKtJ2bRWCI/images/fb/6810ac71bd2b0c22.png?fit=max&auto=format&n=uxzVUXAKtJ2bRWCI&q=85&s=f3d7257f25784b5c80dd0499910dac70" alt="Add new configuration" className="mx-auto" style={{ width:"96%" }} width="1639" height="834" data-path="images/fb/6810ac71bd2b0c22.png" />
</Frame>

## Creating a provision

On the new panel:

1. Enter a unique name for the service.
2. Click the **Provision Category** field and select Web Hosting.

<Frame caption="Select provision category">
  <img src="https://mintcdn.com/upmind/h8h5zREaX7k8Y-3x/images/fb/10819049025dc065.png?fit=max&auto=format&n=h8h5zREaX7k8Y-3x&q=85&s=701a426a62751ef521646a8b63386825" alt="Select provision category" className="mx-auto" style={{ width:"98%" }} width="1566" height="654" data-path="images/fb/10819049025dc065.png" />
</Frame>

3. Select a provider (e.g., cPanel, PLESK, or 20i Hosting). In this example, we select cPanel.
4. Enter the hostname.
5. Enter the WHM username.
6. Enter the WHM API key.

<Frame caption="Enter details">
  <img src="https://mintcdn.com/upmind/c5sDUwEs8YpzGbjA/images/fb/938628ff70b874b6.png?fit=max&auto=format&n=c5sDUwEs8YpzGbjA&q=85&s=fae4baf40923c8590b99ae12412ffb88" alt="Enter details" className="mx-auto" style={{ width:"97%" }} width="1264" height="1044" data-path="images/fb/938628ff70b874b6.png" />
</Frame>

7. Click **Create**.

## Copying WHM information

To complete all the fields in the panel described above, you need to find and copy three pieces of information on your WHM account:

* Hostname
* WHM Username
* API key

To quickly locate the correct information:

1. Open your reseller account.
2. Select the package you want to add to Upmind.

<Frame caption="Select a reseller package">
  <img src="https://mintcdn.com/upmind/A-RwNPXmK_xnEEqe/images/fb/764176feb81fb4ab.png?fit=max&auto=format&n=A-RwNPXmK_xnEEqe&q=85&s=ad539b161341dc5ca4c4ff76c204f1be" alt="Select a reseller package" className="mx-auto" style={{ width:"69%" }} width="1040" height="456" data-path="images/fb/764176feb81fb4ab.png" />
</Frame>

3. On the next page, click the button that logs in to your WHM control panel.

<Note>
  The screenshot below shows a WHM control panel login button for one reseller website. The button on your site will likely look a bit different.
</Note>

<Frame caption="Log in to WHM control panel">
  <img src="https://mintcdn.com/upmind/ZsIo0APxdVb_gFS-/images/fb/279e2f46fc9d6c9c.png?fit=max&auto=format&n=ZsIo0APxdVb_gFS-&q=85&s=dc2f8a1aff7fa4e150053f53a4f36aca" alt="Log in to WHM control panel" className="mx-auto" style={{ width:"73%" }} width="1094" height="290" data-path="images/fb/279e2f46fc9d6c9c.png" />
</Frame>

### Hostname

1. Go to the browser tab with the WHM control panel.
2. Copy a section of the URL. This is the hostname. Do not copy HTTPS://. Do not copy any characters after **.com.**

<Frame caption="WHM hostname">
  <img src="https://mintcdn.com/upmind/wRuKrNY12tQZY8Rr/images/fb/2eda706d817ec14d.png?fit=max&auto=format&n=wRuKrNY12tQZY8Rr&q=85&s=e4cf952aa11baa910fd752aa736f1ea8" alt="WHM hostname" className="mx-auto" style={{ width:"80%" }} width="1002" height="351" data-path="images/fb/2eda706d817ec14d.png" />
</Frame>

3. Go to the Upmind page and paste the value into the Hostname field.
4. Go back to the WHM page.

### WHM Username

1. On the side menu, expand the Account Information folder and click **List Accounts**.

<Frame caption="List WHM accounts">
  <img src="https://mintcdn.com/upmind/92wYnpdR_k6AjH3x/images/fb/50ea338aaee3a7b5.png?fit=max&auto=format&n=92wYnpdR_k6AjH3x&q=85&s=3155c86a75340f49a70a2ea979e231e9" alt="List WHM accounts" className="mx-auto" style={{ width:"71%" }} width="498" height="511" data-path="images/fb/50ea338aaee3a7b5.png" />
</Frame>

2. On the List Accounts page, locate the Username column.
3. Copy the WHM Username of your reseller account.

<Frame caption="Copy username">
  <img src="https://mintcdn.com/upmind/uxzVUXAKtJ2bRWCI/images/fb/66e8032d85a62976.png?fit=max&auto=format&n=uxzVUXAKtJ2bRWCI&q=85&s=40ea82a614c49e498b3e931fe7205aae" alt="Copy username" className="mx-auto" style={{ width:"89%" }} width="980" height="188" data-path="images/fb/66e8032d85a62976.png" />
</Frame>

4. Go back to the Upmind page and paste the value into the WHM Username field.
5. Go back to the WHM page.

### API key

1. Enter **Manage API Tokens** in the search field.
2. Click the best search result.
3. On the **Manage API Tokens** page, click **Generate Token**.

<Frame caption="Generate an API key">
  <img src="https://mintcdn.com/upmind/1xguIfYUrfespmVI/images/fb/7ee485831e169f7b.png?fit=max&auto=format&n=1xguIfYUrfespmVI&q=85&s=618bd1522305729061de0335addb49bc" alt="Generate an API key" className="mx-auto" style={{ width:"85%" }} width="1247" height="660" data-path="images/fb/7ee485831e169f7b.png" />
</Frame>

4. On the next page, enter a token name.
5. Click **Save**.
6. Go back to the Upmind page and paste the value into the API Key field.

### Troubleshooting

| Question                                                                       | Answer                                                                                                                                                          |
| ------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| When logging into cPanel, my users get diverted to a different server hostname | This is a WHM setting for the default hostname. If you have a reseller account it is likely set by your provider. Root owners can set it under 'tweak settings' |
