Promoções

2026-09-18 — Promotions — criar, ler, atualizar e excluir uma promoção; aplicar um cupom a um pedido

🆕 Novo

POST /v1/promotions — Cria uma nova promoção (cupom) para sua empresa: nome, código, desconto, janela de validade, limites de uso e restrições opcionais de produto/tipo de atendimento/público/agenda.
GET /v1/promotions/{id} — Retorna uma única promoção pelo id.
PATCH /v1/promotions/{id} — Atualiza parcialmente uma promoção. Somente os campos enviados são alterados; um campo pode ser definido, mas não limpo de volta para indefinido (enviar null é rejeitado com 422).
DELETE /v1/promotions/{id} — Exclui uma promoção pelo id.

promotions:write — obrigatório para POST /v1/promotions, PATCH /v1/promotions/{id} e DELETE /v1/promotions/{id}. As API keys existentes precisam desse escopo concedido antes de chamá-los.