Skip to main content

Update Amazon Marketplace Pricing

PATCH 

/api/v2/sales-channels/:integrationInstance/prices/marketplaces/:countryCode

Set who prices one non-home marketplace and how. PATCH semantics: every field is optional and a field left out keeps its saved value, so handing a marketplace back to BIL can send {"owner": "channel"} alone. The home marketplace cannot be changed here — its price comes from Update Price Push Settings.

Required scope: integrations:write

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

Authentication: Requires Bearer token.

Requires the integrations.update permission.

Fields (all optional):

  • owner (string): sku (SKU.io prices this marketplace) or channel (Amazon BIL prices it). Handing back to channel keeps the rule, so taking the marketplace over again restores it; turn BIL price sync back on in Seller Central, or the offers keep their last SKU.io price.
  • bil_price_sync_off_confirmed (boolean): required as true when changing owner from channel to sku — confirms that BIL price sync is off for this marketplace in Seller Central. Without it the two would overwrite each other's prices.
  • require_dry_run_first (boolean, default true): when taking a marketplace over, make its next live run a preview only. Ignored otherwise.
  • price_from_tier_ids (array of up to 5 integers|null): pricing level IDs to read the price from, first match wins; null or empty prices from the home listing's price. The first level's currency is the source currency for conversion.
  • method (string): convert, uplift or target_margin
  • uplift_pct (number, -50 to 300): required when method is uplift
  • target_margin_pct (number, 0 to 80): required when method is target_margin
  • rounding (string): none, .99, .95 or .49
  • floor_type (string): none, amount, margin_pct or tier
  • floor_value (number ≥ 0|null): required for amount (in the marketplace currency) and margin_pct (below 100)
  • floor_tier_id (integer|null): the pricing level a tier floor reads
  • floor_action (string|null): adjust (raise the price to the floor) or block (do not send the offer); skip is accepted for block
  • ceiling_type (string): none, amount, markup_pct or tier
  • ceiling_value (number ≥ 0|null): required for amount and markup_pct
  • ceiling_tier_id (integer|null): the pricing level a tier ceiling reads; cannot be the floor's level
  • ceiling_action (string|null): adjust or block (skip accepted)
  • max_delta_pct (number, 0 to 1000|null): largest change allowed against the price last sent
  • max_delta_action (string): skip (skip that offer) or block_run (stop the marketplace's run); skip_listing is accepted for skip

Taking a marketplace over records who confirmed BIL was off and when. Changing the rule of a marketplace SKU.io already prices makes its next live run a preview again, because the earlier preview no longer vouches for the new prices.

Response: the saved row, in the same shape as List Amazon Marketplace Pricing (bound actions read adjust/skip, maximum-change action skip_listing/block_run), and a message.

Returns 422 for the home marketplace, a country the account does not sell in, a missing BIL confirmation, or an invalid rule; 404 for a sales channel that is not Amazon.

  • amazon_allowed_price (object|null): Amazon min/max for this marketplace, amounts in its currency: {min:{mode,value,tier_id}, max:{...}, on_conflict}. Each side and on_conflict may be inherit (same as the home marketplace, converted); null or all-inherit = same as the home marketplace. See Update Amazon Min/Max Settings for modes.

Request​

Responses​

OK

Response Headers
    Content-Type