---
title: "Create unit order"
source_url: https://dev.digicert.com/certcentral-apis/services-api/subaccount/create-unit-order.html
api_method: POST
api_endpoint: "/services/v2/units/order"
api_url: "https://www.digicert.com/services/v2/units/order"
---

**POST** `https://www.digicert.com/services/v2/units/order`

Use this endpoint to create a unit order. Unit orders allow you to buy units for the subaccounts you manage.

To buy units for a subaccount, the pricing method for the subaccount must be set to `units`. To get the pricing method for a subaccount, use the [List subaccount products](https://dev.digicert.com/md/certcentral-apis/services-api/subaccount/list-subaccount-products.md) endpoint.


> **Info**
>
> To create a unit order, the option to allow unit transfers must be enabled for your account. To find out if this option is enabled for your account, contact your account manager.


## Example requests and responses

**cURL**

```bash
curl --request POST 'https://www.digicert.com/services/v2/units/order' \
--header 'X-DC-DEVKEY: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unit_account_id": {{unit_account_id}},
    "notes": "Notes about the order",
    "bundle": [
        {
            "product_name_id": "ssl_securesite_flex",
            "units": "5"
        },
		{
            "product_name_id": "ssl_ev_securesite_flex",
            "units": "20"
        }
    ]
}'
```

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/units/order"

payload = "{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n\t\t{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}"
headers = {
  'X-DC-DEVKEY': {{api_key}},
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data = payload)

print(response.text.encode('utf8'))
```

**Go**

```go
package main

import (
		"fmt"
		"strings"
		"net/http"
		"io/ioutil"
)

func main() {

		url := "https://www.digicert.com/services/v2/units/order"
		method := "POST"

		payload := strings.NewReader("{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n		{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}")

		client := &http.Client {
		}
		req, err := http.NewRequest(method, url, payload)

		if err != nil {
				fmt.Println(err)
		}
		req.Header.Add("X-DC-DEVKEY", {{api_key}})
		req.Header.Add("Content-Type", "application/json")

		res, err := client.Do(req)
		defer res.Body.Close()
		body, err := ioutil.ReadAll(res.Body)

		fmt.Println(string(body))
}
```

**NodeJS**

```javascript
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://www.digicert.com/services/v2/units/order',
  'headers': {
    'X-DC-DEVKEY': {{api_key}},
    'Content-Type': 'application/json'
  },
  body: "{\n    \"unit_account_id\": {{unit_account_id}},\n    \"notes\": \"For Testing Purpose\",\n    \"bundle\": [\n        {\n            \"product_name_id\": \"ssl_securesite_flex\",\n            \"units\": \"5\"\n        },\n\t\t{\n            \"product_name_id\": \"ssl_ev_securesite_flex\",\n            \"units\": \"20\"\n        }\n    ]\n}"

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
```


## 201 Created

```json
{
  "id": 1371
}
```

## Request parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>unit_account_id</td>
<td>required</td>
<td>integer</td>
<td>ID of the subaccount to buy units for.<br>To get IDs for the subaccounts you manage, use the List subaccounts endpoint.</td>
</tr>
<tr>
<td>notes</td>
<td>optional</td>
<td>string</td>
<td>Custom note to attach to the order.<br>Character limit: 512</td>
</tr>
<tr>
<td>bundle</td>
<td>required</td>
<td>array</td>
<td>List of one or more objects with information about the amount of units to order for each type of product.</td>
</tr>
<tr>
<td>.. product_name_id</td>
<td>required</td>
<td>string</td>
<td>Unique identifier for the product that you want to order units for.<br>Allowed values: See Glossary - Product identifiers.</td>
</tr>
<tr>
<td>.. units</td>
<td>required</td>
<td>integer</td>
<td>Amount of units to order for the specified product.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>id</td>
<td>integer</td>
<td>ID of the order.</td>
</tr>
</tbody>
</table>