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

# Create a HAWB

> Create a house air waybill under a shipment.

Create a HAWB under a shipment. Totals must not exceed the shipment.

### Path Parameters

<ParamField path="id" type="string" required>
  Shipment Public ID (`shp_…`).
</ParamField>

### Headers

<ParamField header="Idempotency-Key" type="string" required>
  Unique key that makes retrying this request safe for 24 hours. A UUID is recommended.
</ParamField>

### Body

<ParamField body="houseAirWaybillNumber" type="string" required>
  House air waybill number.
</ParamField>

<ParamField body="packageCount" type="integer" required>
  Package count for this HAWB.
</ParamField>

<ParamField body="grossWeightKg" type="number" required>
  Gross weight in kilograms.
</ParamField>

```json JSON Payload theme={null}
{
  "houseAirWaybillNumber": "HWB-101",
  "packageCount": 4,
  "grossWeightKg": 40
}
```

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "hawbId": "hawb_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
    "shipmentId": "shp_3f9a1c0e5b7d4e2f8a6c1b9d0e3f7a25",
    "houseAirWaybillNumber": "HWB-101",
    "packageCount": 4,
    "grossWeightKg": 40,
    "status": "NOT_INITIATED",
    "isActive": true,
    "reportedStock": { "packageCount": 0, "grossWeightKg": 0 },
    "remainingStock": { "packageCount": 4, "grossWeightKg": 40 },
    "createdAt": "2026-06-10T08:30:00.000Z",
    "updatedAt": "2026-06-10T08:30:00.000Z"
  }
  ```
</ResponseExample>