Skip to main content
​
Authorization
string
required
Bearer token with marketing:write scope
​
id
string
required
The promotion ID

​
Behavior

  • Deletes the promotion and all associated promotion codes
  • Cannot delete promotions that have redemption records
  • For promotions with redemptions, archive them instead by setting status: "archived"

​
Response

Request
curl -X DELETE "https://api.voyantcloud.com/v1/promotions/promo_abc123" \
  -H "Authorization: Bearer $API_KEY"
Response
{
  "success": true
}

​
Errors

StatusErrorDescription
400Cannot delete promotion with redemptionsPromotion has been used. Archive it instead.
404Promotion not foundNo promotion exists with the given ID