Title: Add cWatch Order via the API  
PrimaryCategory: cWatch  
Type: Procedural  
Tags: cwatch, order, api, subscription, reseller, product_order  
Source UI Terms: auth-userid, api-key, domain-name, customer-id, plan-id, noOfMonths, invoice-option, additional-param-json, Content-Type  
Source Reference: Add cWatch Order via the API  

Prerequisites:
- Have the reseller ID and API key for authentication.
- Know the customer ID placing the order.
- Know the domain name to associate with the order.
- Know the cWatch plan ID.
- Determine the subscription duration in months.
- Choose the invoice generation option.

Steps:
1) Prepare a POST request to the endpoint:  
   `https://httpapi.com/restapi/product/cwatch/order`
2) Include the following required query parameters in the request URL:  
   - `auth-userid` (Integer): Reseller ID for authentication  
   - `api-key` (String): Reseller API key for authentication  
   - `domain-name` (String): Domain name to associate with the order  
   - `customer-id` (Integer): ID of the customer placing the order  
   - `plan-id` (Integer): ID of the desired cWatch plan  
   - `noOfMonths` (Integer): Subscription duration in months (e.g., 1)  
   - `invoice-option` (String): Invoice generation choice (e.g., NoInvoice)
3) Optionally, add `additional-param-json` parameter containing a URL-encoded JSON string for extra parameters.
4) Set the HTTP header `Content-Type` to `application/x-www-form-urlencoded`.
5) Send the POST request.
6) Receive a JSON response with the newly created cWatch order details, including `orderid` and `status`.

Summary:
To add a cWatch order via the API, send a POST request with required authentication and order details to the specified endpoint; the response will confirm the order creation with its ID and status.

Evaluation Pairs:
Q: What parameters do I need to include to create a cWatch order via API?  
A: You must include `auth-userid`, `api-key`, `domain-name`, `customer-id`, `plan-id`, `noOfMonths`, and `invoice-option`. Optionally, you can include `additional-param-json`.

Q: What HTTP method and content type should be used to add a cWatch order?  
A: Use the POST method and set the Content-Type header to `application/x-www-form-urlencoded`.

Q: What does the API response include after creating a cWatch order?  
A: The response includes the order ID under `orderid` and the order `status`, usually &quot;Success&quot;.

<div>
<div>
<div>
<div>
<div>
<div>
<h1>Description</h1>
<p>Creates a new cWatch order for a customer.</p>
<h2><a name="heading_0"></a>Parameters</h2>
<table style="width: 597.667px;"><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">Reseller ID (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">Reseller API key (Authentication Parameter)</td></tr><tr><td colspan="1" rowspan="1">domain-name</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Domain name to associate with the order</td></tr><tr><td colspan="1" rowspan="1">customer-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">ID of the customer placing the order</td></tr><tr><td colspan="1" rowspan="1">plan-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">ID of the cWatch plan</td></tr><tr><td colspan="1" rowspan="1">noOfMonths</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Subscription duration in months (e.g. 1)</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">Invoice generation option (e.g. NoInvoice)</td></tr><tr><td colspan="1" rowspan="1">additional-param-json</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Optional</td><td colspan="1" rowspan="1">Optional URL-encoded JSON string for extra parameters</td></tr></tbody></table>
<h2><a name="heading_1"></a>HTTP Method</h2>
<p>POST</p>
<h2><a name="heading_2"></a>Example Request</h2>
<pre>POST <a href="https://httpapi.com/restapi/product/cwatch/order?auth-userid=0&amp;api-key=key&amp;domain-name=example.com&amp;customer-id=322754&amp;plan-id=0&amp;noOfMonths=1&amp;invoice-option=NoInvoice" target="_blank" rel="noopener noreferrer">https://httpapi.com/restapi/product/cwatch/order?auth-userid=0&amp;api-key=key&amp;domain-name=example.com&amp;customer-id=322754&amp;plan-id=0&amp;noOfMonths=1&amp;invoice-option=NoInvoice</a></pre>
<p>Content-Type: application/x-www-form-urlencoded</p>
<h2><a name="heading_3"></a>Response</h2>
<p>Returns the details of the newly created cWatch order, including the Order ID and its status. Representative example:</p>
<pre>{ &quot;orderid&quot;: &quot;854193&quot;, &quot;status&quot;: &quot;Success&quot; }</pre>
</div>
</div>
</div>
</div>
</div>
</div>

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Reseller ID (Authentication Parameter)
api-key	String	Required	Reseller API key (Authentication Parameter)
domain-name	String	Required	Domain name to associate with the order
customer-id	Integer	Required	ID of the customer placing the order
plan-id	Integer	Required	ID of the cWatch plan
noOfMonths	Integer	Required	Subscription duration in months (e.g. 1)
invoice-option	String	Required	Invoice generation option (e.g. NoInvoice)
additional-param-json	String	Optional	Optional URL-encoded JSON string for extra parameters