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

# Create Shipping Dimension

> Create a new shipping dimension preset

<Note>
  **V2 Preview** — This endpoint is part of the V2 API preview. Breaking changes may occur.
</Note>

## Overview

Create a new shipping dimension preset. Presets can be generic (reusable) or product-specific. These are used to pre-fill package dimensions when fetching shipping rates.

### Use Cases

* Save commonly used box sizes for quick rate lookups
* Define product-specific packaging dimensions
* Standardize packaging across the vendor's catalogue

## Request Body

<ParamField body="type" type="string" required>
  Dimension type. Must be `generic` or `productSpecific`.
</ParamField>

<ParamField body="productId" type="string">
  Shopify product ID. Required when `type` is `productSpecific`.
</ParamField>

<ParamField body="title" type="string">
  A human-readable name for the preset (e.g. "Small Box").
</ParamField>

<ParamField body="dimensionUnit" type="string" required>
  Unit of measurement. Must be one of: `in`, `cm`, `mm`, `ft`, `m`, `yd`.
</ParamField>

<ParamField body="heightValue" type="number" required>
  Package height. Minimum 0.
</ParamField>

<ParamField body="widthValue" type="number" required>
  Package width. Minimum 0.
</ParamField>

<ParamField body="lengthValue" type="number" required>
  Package length. Minimum 0.
</ParamField>

## Response

```json 200 theme={null}
{
  "success": true,
  "data": {
    "_id": "665a1b2e3d98f0001a2b3c52",
    "type": "generic",
    "title": "Medium Box",
    "dimensionUnit": "in",
    "heightValue": 8,
    "widthValue": 10,
    "lengthValue": 12
  }
}
```

## Example

```bash theme={null}
curl -X POST "https://staging-api.puppetvendors.com/shipping/dimensions" \
  -H "x-access-token: YOUR_VENDOR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "generic",
    "title": "Medium Box",
    "dimensionUnit": "in",
    "heightValue": 8,
    "widthValue": 10,
    "lengthValue": 12
  }'
```