create_product

Updated May 21, 20261 min read

Create a product via POST /products/{merchant}.

Parameters

NameTypeRequiredDescription
merchantstringYes—
tenantIdstringYes—
barcodestringNo—
batteryobjectNo—
carriyo_metadataarrayNo—
categorystringNo—
dangerous_goodsbooleanNo—
descriptionstringNo—
digitalbooleanNo—
dimensionobjectNo—
do_not_place_abovebooleanNo—
do_not_place_belowbooleanNo—
hs_codestringNoHarmonized System product classification code.
image_linkstringNo—
manufacturer_idstringNo—
material_compositionstringNo—
non_returnablebooleanNo—
origin_countrystringNoISO 3166-1 alpha-2 country code.
product_idstringNoCarriyo product ID. Optional on create; backend generates one if omitted.
product_refstringNoMerchant product reference.
skustringNo—
statusstringNoValues: ACTIVE, INACTIVE, DELETED.
weightobjectNo—

Example agent prompt

"Create a new product."

create_product( tenantId="…", merchant="acme" )