Skip to main content

Bulk Update Listing Inventory Settings

POST 
/api/v2/listings/bulk-update-inventory-settings

Applies inventory settings to many listings at once. Runs synchronously — the response reports the number of listings updated.

Required scope: products:write

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

Targeting (one of):

  • ids (array of integers, required unless apply_to_all is true) — explicit listing IDs
  • apply_to_all: true — target every listing matching the optional filters object: search (listing SKU / title / channel listing ID), integration_id, is_fba (true/false). Only non-archived listings are targeted in this mode.

inventory_settings (required, object): inventory_settings fields (all optional within the object):

  • inherit (boolean) — when true, clears all listing-level overrides so the listing inherits settings from its channel account; all other settings fields are ignored
  • master_of_stock (string|null) — one of: sku.io, sales_channel, amazon, neither
  • warehouse_ids (array of integers|null) — warehouse IDs used for the listing's available quantity
  • warehouse_action (string) — how warehouse_ids are applied: replace (default), add, or clear
  • fulfillment_latency (integer|null, 0-30) — handling time in days
  • max_rule_type (string|null) — one of: None, Fixed Allocation, % of Available
  • max_rule_value (number|null, min 0) — value paired with max_rule_type
  • min_rule_type (string|null) — one of: None, Fixed Allocation, % of Available
  • min_rule_value (number|null, min 0) — value paired with min_rule_type
  • subtract_buffer_stock (integer|null, min 0) — buffer quantity subtracted from availability

Behavior notes:

  • Only the fields present in inventory_settings are changed; omitted fields keep their current values.
  • inherit: true is destructive — it deletes all listing-level overrides so the listing inherits from its channel account; any other settings sent alongside it are ignored.
  • warehouse_action controls how warehouse_ids merge with existing selections: replace (default) overwrites, add unions, clear empties the selection.
  • FBA listings are always skipped (their inventory is managed by the fulfillment network) and do not count toward the affected total.

Use Preview Bulk Listing Inventory Settings Update first for a dry run of the same payload.

Authentication: Requires Bearer token.

Note: inventory_settings.inherit = true resets the listing's inventory overrides but PRESERVES any per-listing FBM Backup rule (inventory_rules.fbmBackup) — that rule is orthogonal to inventory inheritance.

Request​

Responses​

OK

Response Headers
    Content-Type