Bolt has moved to boltapp.com. Stores still using bolt.com hosts must update now: see the migration guide.

Skip to content

Delete a promotion by ID

View As MarkdownMCP
DELETE
/v1/subscriptions/promotions/{promotionId}

Deactivates the promotion, item or cart, by its ID alone. New carts stop receiving the discount; subscriptions that already captured it keep their terms. A promotion still in draft is deleted outright.

Authorization

X-API-Key<token>

Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard. Send it together with X-Publishable-Key.

In: header

Path Parameters

promotionId*string

ID of the promotion to delete.

Response Body

application/json

application/json

application/json

curl -X DELETE "https://example.com/v1/subscriptions/promotions/bcp_V9y3q4Jw8kQe"
{  "success": true}