Title: Add a WHMCS License Key to a Reseller Linux Hosting Order Using the API  
PrimaryCategory: WHMCS  
Type: Procedural  
Tags: WHMCS, license_key, reseller_hosting, API, linux_hosting  
Source UI Terms: auth-userid, api-key, order-id, invoice-option, POST  
Source Reference: Add a WHMCS License Key to a Reseller Linux Hosting Order Using the API  

---

### Prerequisites:
- Obtain your `auth-userid` and `api-key` for authentication.
- Know the `order-id` of the Reseller Linux Hosting order you want to add the license key to.
- Determine the desired `invoice-option` for customer invoice handling.

### Steps:
1) Prepare a POST API request to the endpoint based on your server location:  
   - US Server:  
   `https://[test.].httpapi.com/api/resellerhosting/linux/us/generate-license-key.json`  
   - India Server:  
   `https://[test.].httpapi.com/api/resellerhosting/linux/in/generate-license-key.json`
2) Include the following required parameters in the query string or request body:  
   - `auth-userid` (Integer): Your authentication user ID.  
   - `api-key` (String): Your API key for authentication.  
   - `order-id` (Integer): The order ID to which the WHMCS license key will be added.  
   - `invoice-option` (String): Controls invoice handling, must be one of the following:  
     - `NoInvoice`  
     - `PayInvoice`  
     - `KeepInvoice`  
     - `OnlyAdd`
3) Send the POST request.
4) Receive the response, which will return a map with execution details of adding the WHMCS license key.

### Summary:
This procedure explains how to add a WHMCS license key to a Reseller Linux Hosting order via the API using the required authentication parameters and invoice handling options.

### Evaluation Pairs:

Q: What authentication parameters are required to add a WHMCS license key to a reseller hosting order using the API?  
A: The required authentication parameters are `auth-userid` (an integer) and `api-key` (a string).

Q: Which HTTP method must be used when making the API call to generate a WHMCS license key for a reseller hosting order?  
A: The API call must use the POST HTTP method.

Q: What are the valid values for the `invoice-option` parameter, and what is its purpose?  
A: The valid values are `NoInvoice`, `PayInvoice`, `KeepInvoice`, and `OnlyAdd`. This parameter determines how customer invoices are handled during license key generation.

<div class="region region-content">
<div class="block block-core block-page-title-block" id="block-twostates-page-title">
<div class="content">
<div id="toc" style="display: block;">
<div id="toc_content">
<p>When you want to add a WHMCS license key to an existing Reseller Linux Hosting order using the API. This article explains the required parameters, billing options, and API request details for WHMCS license provisioning.</p>
<p> </p>
</div>
</div>
</div>
</div>
<div class="node__content clearfix">
<div class="layout layout--onecol">
<div class="layout__region layout__region--content">
<div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item">
<h2><a name="heading_0"></a>Description</h2>
<p>Adds the WHMCS license key for the specified Reseller Linux Hosting Order</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable"><tbody><tr><th colspan="1" rowspan="1">Name</th><th colspan="1" rowspan="1">Data Type</th><th colspan="1" rowspan="1">Required / Optional</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">api-key</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">order-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">The Order ID for which the license key is to be generated.</td></tr><tr><td colspan="1" rowspan="1">invoice-option</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">This parameter will decide how the Customer Invoices will be handled. Values can be: <em>NoInvoice</em>, <em>PayInvoice</em>, <em>KeepInvoice</em>, <em>OnlyAdd</em></td></tr></tbody></table>
<h2><a name="heading_2"></a>HTTP Method</h2>
<p>POST</p>
<h2><a name="heading_3"></a>Example Test URL Request</h2>
<p><strong>US Server</strong> <code> https://test.httpapi.com/api/resellerhosting/linux/us/generate-license-key.json?auth-userid=0&amp;api-key=key&amp;order-id=0&amp;invoice-option=NoInvoice </code> <strong>India Server</strong> <code> https://test.httpapi.com/api/resellerhosting/linux/in/generate-license-key.json?auth-userid=0&amp;api-key=key&amp;order-id=0&amp;invoice-option=NoInvoice </code></p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns a map of the execution details of adding the WHMCS License key.</p>
</div>
</div>
</div>
</div>
</div>
<div class="seedetailssection"> </div>

When you want to add a WHMCS license key to an existing Reseller Linux Hosting order using the API. This article explains the required parameters, billing options, and API request details for WHMCS license provisioning.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
order-id	Integer	Required	The Order ID for which the license key is to be generated.
invoice-option	String	Required	This parameter will decide how the Customer Invoices will be handled. Values can be: NoInvoice, PayInvoice, KeepInvoice, OnlyAdd