> ## 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 Father package

> Creates a Father package by consolidating multiple Son packages for bulk first-mile shipping.

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

<Note>
  nocnoc manages two types of packages: **Son** and **Father**. You must first create individual [Son packages](/api/api-reference/packages/create-son-package) before grouping them into a Father package.
</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="subpackages" type="array" required>
  Array of Son package IDs to include in this Father package.
</ParamField>

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

  * `tracking_code` (string, required) — tracking code of the consolidated package
  * `carrier` (string, required) — first-mile carrier (e.g. `"FedEx"`, `"UPS"`)
  * `url` (string, required) — URL to track the shipment
</ParamField>

## Returns

The created Father package object confirming the consolidated shipment.

## 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 '{
    "labels": [
      {
        "tracking_code": "FX2021",
        "carrier": "FedEx",
        "url": "https://www.fedex.com/tracking/FX2021"
      }
    ],
    "subpackages": ["PK1", "PK2", "PK3"]
  }'
```

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