PUT /pricelists/{price_list_id}/records/{variant_id}/{currency_code}

Creates or updates a Price List Record using the currency code. Notes

Supports up to 40 simultaneous PUT requests. Running more than the allowed number of requests concurrently on the same store will result in a 429 status error, and your additional requests will fail.

Servers

https://api.bigcommerce.com/stores/{store_hash}/v3

Path parameters

Name	Type	Required	Description
`price_list_id`	Integer	Yes	The ID of the `Price List` requested.
`currency_code`	String	Yes	The currency code associated with the price record being acted upon.
`variant_id`	Integer	Yes	ID of the variant on a product, or on an associated Price List Record.

Request headers

Name Type Required Description

Name	Type	Required	Description
`Accept`	String	Yes	The MIME type of the response body. Default value: "application/json"
`Content-Type`	String	Yes	The MIME type of the request body. Default value: "application/json"

Accept

String

Yes

The MIME type of the response body.

Default value: "application/json"

Content-Type

String

Yes

The MIME type of the request body.

Default value: "application/json"

Request body fields

Name	Type	Required	Description
`map_price`	Number	No	The MAP (Minimum Advertised Price) for the variant mapped in a Price List. Overrides any existing or Catalog MAP price for the variant/product. If empty, the MAP price will be treated as not being set on this variant.
`price`	Number	No	The list price for the variant mapped in a Price List. Overrides any existing or Catalog list price for the variant/product.
`retail_price`	Number	No	The retail price for the variant mapped in a Price List. Overrides any existing or Catalog retail price for the variant/product. If empty, the retail price will be treated as not being set on this variant.
`sale_price`	Number	No	The sale price for the variant mapped in a Price List. Overrides any existing or Catalog sale price for the variant/product. If empty, the sale price will be treated as not being set on this variant.
`bulk_pricing_tiers[]`	Array	No
`bulk_pricing_tiers[].amount`	Number	No	The price adjustment amount. This value along with the type will decide the price per variant for the pricing tier.
`bulk_pricing_tiers[].type`	String	No	The type of adjustment that is made. Acceptable values: price – the adjustment amount per product; percent – the adjustment as a percentage of the original price; fixed – the adjusted absolute price of the product. Possible values: `"fixed"` `"price"` `"percent"`
`bulk_pricing_tiers[].quantity_min`	Integer	No	The minimum quantity of associated variant in the cart needed to qualify for this tiers pricing.
`bulk_pricing_tiers[].quantity_max`	Integer	No	The maximum allowed quantity of associated variant in the cart to qualify for this tiers pricing.

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.