> ## 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 shipment

> Create a new shipment that can be used for declarations submitted via external API.

Create a new shipment that can be used for declarations submitted via external API.

### Body

<ParamField body="referenceNumber" type="string" required>
  The unique reference number of the shipment (e.g., Master Bill of Lading, Air Waybill).
</ParamField>

<ParamField body="localReferenceNo" type="string">
  The local reference number or Purchase Order number.
</ParamField>

<ParamField body="remarks" type="string">
  Additional remarks or notes for the shipment.
</ParamField>

<ParamField body="totalWeight" type="number">
  The total gross weight of the shipment.
</ParamField>

<ParamField body="totalPrice" type="number">
  The total value or price of the shipment.
</ParamField>

<ParamField body="autoClearance" type="boolean">
  Whether to automatically trigger clearance when declaration is ready.
</ParamField>

<ParamField body="autoPreclearance" type="boolean">
  Whether to automatically trigger preclearance when declaration is ready.
</ParamField>

```json JSON Payload theme={null}
{
  "referenceNumber": "180-43189000",
  "localReferenceNo": "PO-2026-001",
  "remarks": "External API shipment",
  "totalWeight": 480,
  "totalPrice": 9500,
  "autoClearance": true,
  "autoPreclearance": true
}
```

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "shipmentId": 99,
    "referenceNumber": "180-43189000",
    "localReferenceNo": "PO-2026-001",
    "remarks": "External API shipment",
    "totalWeight": 480,
    "totalPrice": 9500,
    "status": "draft",
    "createdAt": "2026-06-22T17:00:00.000Z",
    "updatedAt": "2026-06-22T17:00:00.000Z"
  }
  ```
</ResponseExample>