Save Amazon Min/Max Exceptions
PUT/api/v2/sales-channels/:integrationInstance/prices/amazon-allowed-price/overrides
Create or replace one Amazon min/max exception on many products and listings. Each side left out is inherit ("Same as profile"). Every product must have a listing on this channel and every listing must be on it.
integrations:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token. Requires the integrations.update permission.
Fields:
- targets (array, required, 1-5,000): [{type: product|product_listing, id}].
- min, max (object, optional): {mode, value, tier_id}.
- on_conflict (string|null, optional): hold, widen, send, or inherit/null.
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.
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.