Skip to main content

Create Blemished Product

POST 
/api/products/blemished

Create a blemished (damaged/used) product derived from an existing standard product.

Required scope: products:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Authentication: Requires Bearer token.

Body fields:

  • blemished_sku (required, unique): SKU for the new blemished product
  • derived_from_product_id (required): ID of the original standard product
  • product_condition_id (optional): ID of a product condition grade (from List Product Conditions)
  • condition_notes (optional): free-text note describing the blemish
  • reference (optional): reference number or note
  • adjust_inventory (optional, boolean, default false): create an inventory adjustment
  • adjust_inventory_for_original_product (optional, boolean): also adjust the original product
  • adjustment_type (optional, default 'increase'): increase or decrease
  • adjustment_data (optional): adjustment details when adjust_inventory is true

Requires permission: products.create

Request​

Responses​

OK

Response Headers
    Content-Type