Skip to main content

Create Pricing Sync Profile

POST 
/api/v2/pricing-sync-profiles

Create a pricing sync profile.

Required scope: integrations:write

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

A profile is a named, reusable price-push policy. It does nothing until it is assigned — as a channel default (Set Channel Default Pricing Sync Profile), on products (Update Product / Bulk Assign Product Pricing Sync Profile) or on listings (Update Product Listing / Bulk Assign Pricing Sync Profile to Listings).

Authentication: Requires Bearer token.

Requires the integrations.update permission (API tokens: integrations:write scope).

Request body:

  • name (string, required, max 80): unique across all profiles.
  • sequence_tier_ids (array of integers, required, may be empty, max 5): the pricing level IDs to try in order — the first level that prices a product supplies its price. Every level must exist and all must share one currency. An empty sequence is a legal policy that sends nothing. Archived levels are accepted: an archived level still prices, it only leaves the pickers.
  • floor_type (string, required): none, amount, margin_pct or tier.
  • floor_value (number, min 0): required when floor_type is amount (a price) or margin_pct (a margin over landed cost — must be below 100). Cleared for none and tier.
  • floor_tier_id (integer): required when floor_type is tier — the pricing level whose price is the floor (e.g. MAP).
  • floor_action (string, optional): block or adjust. Null uses the type's default — a tier floor adjusts the price up to the level, every other floor blocks the push.
  • ceiling_type (string, required): none, amount, markup_pct or tier.
  • ceiling_value (number, min 0): required when ceiling_type is amount or markup_pct (a markup over landed cost). Cleared for none and tier.
  • ceiling_tier_id (integer): required when ceiling_type is tier.
  • ceiling_action (string, optional): block or adjust. Null uses the type's default — a tier ceiling adjusts the price down to the level, every other ceiling blocks the push.
  • max_delta_pct (number, optional, 0–100): the largest change, as a percentage of the last pushed price, a single push may make. Null disables the limit.
  • max_delta_action (string, required): what happens when the limit is exceeded — skip (skip that listing) or block_run (stop the whole run).
  • automated_pricing_rule_id (string, optional, max 120, letters, digits, ., _, :, -): an Amazon Seller Central Automate Pricing rule ID such as 328182282407-COMPETITIVE_BUYBOX. Other channels ignore it.

Cross-field rules (422): a tier floor or ceiling needs its level; the floor and the ceiling cannot both use the same level; an amount floor above an amount ceiling is refused; a margin floor of 100% or more is refused.

Returns 201 with the new profile and a confirmation message.

Request​

Responses​

Created

Response Headers
    Content-Type