Delete Promotion

Delete a promotion and its associated codes

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

Status	Error	Description
400	Cannot delete promotion with redemptions	Promotion has been used. Archive it instead.
404	Promotion not found	No promotion exists with the given ID