Skip to main content
POST
Create Shipping Dimension
V2 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

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

string
required
Dimension type. Must be generic or productSpecific.
string
Shopify product ID. Required when type is productSpecific.
string
A human-readable name for the preset (e.g. “Small Box”).
string
required
Unit of measurement. Must be one of: in, cm, mm, ft, m, yd.
number
required
Package height. Minimum 0.
number
required
Package width. Minimum 0.
number
required
Package length. Minimum 0.

Response

200

Example