Create Product

post

https://api.shipmonk.com/v1/integrations/product

ERP push to ShipMonk
ShipMonk will ensure that only single Product with matching SKU exists and will reject repeated requests.
Possible values for required_packaging
- poly_mailer, bubble_mailer, box, slap_a_label
- ShipMonk will use this field to resolve lowest level of packaging for orders.
Field country_of_origin will accept 2 letter ISO 3166-1-alpha2 country code
Updates to products will be made directly in ShipMonk UI

Fragile products

If you mark product as fragile, the selected packaging must be box.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

product_key

string

required

length between 3 and 255

Unique identifier for the product in your system. Must be unique across all products.

sku

string

required

length between 3 and 255

Stock Keeping Unit — unique product identifier. Must be unique across all active products.

name

string

required

length between 3 and 255

Human-readable product name.

required_packaging

string

enum

required

Minimum packaging type required for this product.

Allowed:

fragile

boolean

required

Whether the product requires fragile handling during fulfillment. If you mark product as fragile, the selected packaging must be box.

replacement_cost

double

required

Cost to replace the product, used for insurance and claims purposes. Must be a positive value in the currency specified by currencyCode.

customs_declaration_value

double

required

Declared value of goods for customs purposes, used to calculate duties and taxes upon import. Required for international shipments. Must be a positive value in the currency specified by currencyCode.

country_of_origin

string

required

length between 2 and 2

Two-letter ISO 3166-1 alpha-2 country code indicating the product's country of origin for customs documentation on international shipments (e.g. US, DE, CN).

barcodes

array of strings

required

List of barcodes associated with the product (e.g. UPC, EAN, ISBN). Each barcode must be between 1 and 255 characters.

barcodes*

dimensions_in

Physical dimensions of the product in inches.

weight_lb

double | null

Defaults to null

Product weight in pounds (decimal value). Must be a positive number.

currency_code

string

length between 3 and 3

Defaults to USD

Three-letter ISO 4217 currency code used for replacementCost and customsDeclarationValue (e.g. USD, EUR). Defaults to USD.

hs_code

string | null

Defaults to null

Harmonized System (HS) code used for customs classification. Maximum 255 characters.

hs_codes

array of objects

Defaults to

List of region-specific Harmonized System (HS) codes for customs classification.

hs_codes

image_url

string | null

Defaults to null

URL of the product image. Must be a valid URL and unique across all products.

custom_data

array of objects

Defaults to

List of custom key-value data items to associate with the product (e.g. for integration-specific metadata).

custom_data

product_handling_units

array of objects

Defaults to

List of handling units (inner carton, master carton, pallet) describing the product's packaging hierarchy for receiving and storage.

product_handling_units

lot_control_settings

Lot control settings specifying whether lot number and/or expiration date tracking is required for this product.

Response

200Success