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.
integrations:writeGrant 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) orchannel(Amazon BIL prices it). Handing back tochannelkeeps 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
truewhen changing owner fromchanneltosku— 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,upliftortarget_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,.95or.49 - floor_type (string):
none,amount,margin_pctortier - floor_value (number ≥ 0|null): required for
amount(in the marketplace currency) andmargin_pct(below 100) - floor_tier_id (integer|null): the pricing level a
tierfloor reads - floor_action (string|null):
adjust(raise the price to the floor) orblock(do not send the offer);skipis accepted forblock - ceiling_type (string):
none,amount,markup_pctortier - ceiling_value (number ≥ 0|null): required for
amountandmarkup_pct - ceiling_tier_id (integer|null): the pricing level a
tierceiling reads; cannot be the floor's level - ceiling_action (string|null):
adjustorblock(skipaccepted) - max_delta_pct (number, 0 to 1000|null): largest change allowed against the price last sent
- max_delta_action (string):
skip(skip that offer) orblock_run(stop the marketplace's run);skip_listingis accepted forskip
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
- 200
- 401
- 403
- 404
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
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.
Not Found
Response Headers
Unprocessable Content
Response Headers
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.