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

# Create Son package

> Creates a Son package for a single order. Each order requires its own Son package.

<Note>Requests go to the live environment — all actions are real.</Note>

<Note>
  nocnoc manages two types of packages: **Son** and **Father**. Create a Son package per order, then group multiple Son packages into a [Father package](/api/api-reference/packages/create-father-package) for consolidated first-mile shipping.
</Note>

## Authorization

<ParamField header="X-Api-Key" type="string" required>
  Your seller API key. Provided by your nocnoc account manager.
</ParamField>

## Body parameters

<ParamField body="order_reference_id" type="string" required>
  The reference ID of the order included in this package.
</ParamField>

<ParamField body="labels" type="array" required>
  Array of label objects. Minimum 1, maximum 10. Each object contains:

  * `tracking_code` (string) — tracking code of the package
  * `carrier` (string) — first-mile carrier (e.g. `"FedEx"`, `"UPS"`). Use `"nocnoc"` for a nocnoc label
  * `url` (string) — URL to track the order
</ParamField>

<ParamField body="items" type="array" required>
  Array of item objects inside the package. Minimum 1, maximum 10. Each object contains:

  * `sku` (string) — item SKU, between 1 and 45 characters
  * `quantity` (integer) — quantity of the item, between 0 and 9999
</ParamField>

## Returns

The created Son package object with its package ID, which you'll need to create a Father package.

## Example request

```bash theme={null}
curl -X POST https://live.nocnocstore.com/api/v2/packages \
  -H "X-Api-Key: YOUR_SELLER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_reference_id": "NC0000",
    "labels": [
      {
        "tracking_code": "1234",
        "carrier": "nocnoc",
        "url": "https://tracking.example.com/1234"
      }
    ],
    "items": [
      {
        "sku": "SKU00000000",
        "quantity": 1
      }
    ]
  }'
```

<ResponseExample>
  ```json 201 theme={null}
  {
    "package_id": "PK111"
  }
  ```
</ResponseExample>