Skip to main content

Update Pricing Sync Profile

PUT 
/api/v2/pricing-sync-profiles/:pricingSyncProfile

Update a pricing sync profile. The profile is replaced whole — send every field, not just the ones that changed.

Required scope: integrations:write

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

When the price-shaping policy changed (sequence, floor, ceiling, maximum change or Amazon rule) and the profile is in use, every listing it governs is re-priced in the background and tracked_job_log_id identifies that job. A rename, or a save that changed nothing, re-prices nothing and returns tracked_job_log_id: null.

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.

  • updated_at (ISO-8601 datetime, optional): the updated_at you last read. When it no longer matches the stored value — someone else saved the profile in between — the update is refused with 422 on updated_at and nothing is written. Omit it to skip the check.

Request​

Responses​

OK

Response Headers
    Content-Type