Set Amazon Business Overrides
PUT/api/v2/sales-channels/:integrationInstance/prices/business/overrides
Give listings and/or products their own Amazon Business pricing policy on this Amazon account, replacing any override they already have. Only the Business policy changes; the consumer guardrails stay as they are.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token.
Requires the integrations.update permission (API tokens: integrations:write scope).
A Business override replaces only the Business pricing policy for its listing or product on this Amazon account; the consumer price and its floor, ceiling and maximum-change guardrails stay as they are. The Business policy in force for a listing is, in order: the listing's override › its product's override on this account › the Business policy of the listing's pricing sync profile › the channel's own Business setting.
Request body:
- product_listing_ids (array of integers, max 5000, distinct): listings to override. Every one must be a listing on this Amazon account, or the request is refused with 422. Required unless
product_idsis sent. - product_ids (array of integers, max 5000, distinct): products to override; the override applies to the product's listings on this Amazon account. Each product must exist. Required unless
product_listing_idsis sent. - business_pricing (object, required): the policy.
{"mode": "off"}stops the Business price for these listings or products. Fields: - mode (string, required when the object is sent):
off(never send a Business price — whatever Seller Central holds stays live; the default),percent_off_consumer(the consumer price lesspercent_off),tier_sequence(the first oftier_idsthat prices the product, falling back topercent_offwhenfallback_percent_offis true) ormatch_consumer(the Business price equals the consumer price). - percent_off (number|null, 0–50, up to 2 decimals): percent off the consumer price. Required for
percent_off_consumer, and fortier_sequencewhilefallback_percent_offis true. - tier_ids (array of integers, max 10): pricing level IDs to read the Business price from, in order. Each must exist and not be archived. At least one is required for
tier_sequence. - fallback_percent_off (boolean, default true): with
tier_sequence, usepercent_offfor a product none of the levels prices; when false that product gets no Business price. - rounding (string, default
none):none,.99,.95or.49— the ending applied to the Business price. - quantity_discounts (object): the quantity-discount ladder sent with the Business price.
- mode (string, default
leave):leave(never send quantity discounts; Seller Central keeps whatever it has),clear(remove any quantity discounts Amazon shows),percent_ladder(thelevelsbelow, sent as percent off the Business price) orquantity_breaks(the product's quantity-break prices in the pricing levelquantity_break_tier_id, sent as fixed unit prices). Anything other thanleaveneeds a Business pricemodeother thanoff. - levels (array, max 5):
{min_quantity, percent_off}—min_quantityan integer of at least 2,percent_offgreater than 0 and at most 50. Each level needs a higher quantity AND a bigger discount than the one before it. At least one is required forpercent_ladder. - quantity_break_tier_id (integer|null): the pricing level whose quantity breaks become the ladder. Required for
quantity_breaks; must exist and not be archived. - fallback_to_levels (boolean, default false): with
quantity_breaks, uselevelsfor a product that has no quantity breaks in that level.
- mode (string, default
A level that would not be a real discount — a quantity under 2, a price not below the Business price or the level before it, a price below the floor, or more than 5 levels — is left out of what is sent rather than refusing the whole offer; the price push records each one left out.
Response data: listings and products (how many of each were set), mode (the saved mode) and dry_run_pending (true when the next price push will preview Business prices first; setting a policy that turns a Business price on always does this).
Returns 422 for an invalid policy, a listing on another account, a missing product, or an account with no sales channel.
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 Entity
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.