Skip to main content
POST
Bulk update product sale price
Sets the promotional (sale) price for multiple products in the store at once. Pass null to clear the sale. The response message states how many were updated; no data payload is returned. Requires the WRITE_INVENTORY scope.

Authorizations

Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Body

application/json
productIds
string[]
required

Array of product ObjectIds (at least one).

promoPrice
number | null
required

Promotional price to set on all listed products (>= 0), or null to clear the sale.

Response

Bulk update product sale price — success.

status
integer
required
Example:

200

success
boolean
required
Example:

true

message
string
required
Example:

"Bulk update product sale price"

data
object | null
required
Example: