Update Amazon Min/Max Settings
PUT/api/v2/sales-channels/:integrationInstance/prices/amazon-allowed-price
Save the channel's Amazon min/max allowed price settings. Every other pricing setting is kept. Saving is recorded in the activity log.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token. Requires the integrations.update permission.
Fields:
- min (object, required): {mode, value, tier_id}.
- max (object, required): {mode, value, tier_id}.
- on_conflict (string, required):
hold(don't send a price outside a Seller Central limit; flag it),widen(send it and move that limit to the price) orsend(send anyway). - automated_pricing_rule_id (string|null, optional): the Seller Central Automate Pricing rule id; leave out to keep the saved rule.
Modes per side: leave (don't change Amazon's; default), clear (remove from Amazon), fixed (amount, value > 0, in the marketplace currency), tier (the product's price in pricing level tier_id), percent_of_price (value% of the price sent; minimum 1-100, maximum 100 or more), margin_pct (minimum only, value 0 to below 100), markup_pct (maximum only, value 0 or more), guardrail (copy the SKU.io guardrail floor/ceiling). inherit is accepted only on profiles, marketplaces and exceptions. Two fixed amounts must satisfy min < max. Minimum is rounded down and maximum up to the cent.
An Automate Pricing rule with minimum mode clear returns 422: "Amazon Automate Pricing needs a minimum price. Choose a min, or remove the rule."
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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.