Update Product Listing

PUT 
/api/v2/product-listings/:productListing

Updates a product listing. If master_of_price or product_pricing_tier_id change, the price is pushed to the sales channel.

Required scope: products:write

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

master_of_price / master_of_stock accept sku.io, sales_channel, or neither (null inherits). The effective master_of_stock is driven by inventory_rules.masterOfStock.

Authentication: Requires Bearer token.

FBM Backup Mode (Amazon MFN listings only): send inventory_rules.fbmBackup = { inherit: bool, enabled: bool, fbaThreshold: int>=0, scope: "same_country"|"all_marketplaces" }. inherit:true (or omitting fbmBackup) inherits the Amazon integration default; inherit:false is a per-listing override. The response fbm_backup carries the EFFECTIVE config, inherited (bool), the integration_default, and (when effectively enabled) the live gate status. Enabling an override on a non-Amazon or FBA listing returns 422. fbm_backup is null only for non-Amazon-MFN listings.

Inventory modification rules: send inventory_rules.inventoryModificationRules = { maxRuleType: string, maxRuleTypeValue: numeric|null, minRuleType: string, minRuleTypeValue: numeric|null, subtractBufferStock: numeric|null }. All value fields are nullable; subtractBufferStock subtracts a buffer from the quantity pushed to the channel (null/0 = no buffer).

Request

Responses

200

OK

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

422

Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.

429

Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.