---
title: "Criar promoção"
method: POST
path: "/{alias}/pricing/promotions"
tags: ["Promoções - Produtos"]
---

# Criar promoção

`POST /{alias}/pricing/promotions`

Cria uma nova promoção

## Path parameters

- `alias` string, required

## Request body

- PromotionRequest — Dados para criação ou atualização de uma promoção
  - `active` boolean, required — Status da promoção
  - `all_products` boolean, required — Aplicar em todos os produtos
  - `utm_only` boolean, required — Exclusivo para UTM
  - `highlight_on_menu` boolean — Destacar no menu
  - `accumulate` boolean — Permite acumular com outras promoções
  - `price_attribute` 'price_sale' | 'price_discount', required — Atributo de preço para aplicar desconto
  - `name` string, required — Nome da promoção
  - `value` number, float, required — Valor do desconto
  - `utm_source` string — Origem UTM
  - `utm_campaign` string — Campanha UTM
  - `start_at` string, date-time, required — Data e hora de início
  - `end_at` string, date-time, required — Data e hora de término
  - `collections_ids` integer[] — IDs das coleções
  - `brands_ids` integer[] — IDs das marcas
  - `categories_ids` integer[] — IDs das categorias
  - `banners_ids` integer[] — IDs dos banners

## Response `201`

Promoção criada com sucesso

- Promotion
  - `id` integer
  - `active` boolean
  - `all_products` boolean
  - `utm_only` boolean
  - `highlight_on_menu` boolean
  - `accumulate` boolean
  - `price_attribute` string
  - `name` string
  - `expired` boolean
  - `url` string, uri
  - `slug` string
  - `value` number, float
  - `utm_source` string
  - `utm_campaign` string

## Other responses

- `400` — Requisição inválida

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)