API ReferencePromotions
Delete a promotion
DELETE /rest/v1/promotions/{id}
Only draft, ended or stopped promotions, once every channel price is back (409 promotion_running while it runs, 409 promotion_reverting while prices are being restored).
Required scope: promotions:write.
Authorization
apiKey AuthorizationBearer <token>
Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.
In: header
Path Parameters
id*string
Header Parameters
Idempotency-Key?string
Unique client-generated key (max 255 chars), stored 24h.
Length
length <= 255Response Body
application/json
application/json
application/json
curl -X DELETE "https://example.com/promotions/promo_66f0a1"{ "id": "string", "object": "string", "deleted": true, "simulated": true}Last updated on October 18, 2026
Need help?
Email us and a human replies, usually within one business day.