Mass Delete Cart Rule Coupons

Deletes several coupons from a cart rule in one call — the Mass Delete action on the Coupons tab of the admin Marketing → Promotions → Cart Rules screen.

TIP

New here? Read the Cart Rule Coupons overview for what these coupons do and how they relate to a cart rule.

Endpoint

Endpoint	Method
/api/admin/marketing/cart-rules/{cartRuleId}/coupons/mass-delete	POST

Details

• Requires an admin Bearer token and the marketing.promotions.cart_rules.delete permission.
• Ids that don't belong to the named cartRuleId are silently skipped (returned in skipped); the ids actually removed are returned in deleted.
• An empty or missing indices list returns a 422 error.

Request body

Field	Type	Required	Notes
indices	int[]	yes	Non-empty list of coupon ids to delete