---
title: "Criar banner"
method: POST
path: "/{alias}/marketing/banners"
tags: ["Marketing"]
---

# Criar banner

`POST /{alias}/marketing/banners`

Cria um novo banner

## Path parameters

- `alias` string, required

## Request body

- BannerRequest — Representa os dados necessários para criar ou atualizar um banner
  - `active` boolean — Indica se o banner está ativo
  - `home` boolean — Indica se o banner aparece na home
  - `name` string — Nome do banner. O valor é sanitizado e normalizado automaticamente.
  - `link` string — Link do banner
  - `image_url` string — URL da imagem do banner
  - `start_at` string, date-time — Data e hora de início
  - `end_at` string, date-time — Data e hora de término
  - `categories_ids` integer[] — IDs das categorias
  - `collections_ids` integer[] — IDs das coleções
  - `promotions_ids` integer[] — IDs das promoções

## Response `201`

Banner criado com sucesso

- object
  - `id` integer
  - `product_id` integer
  - `active` boolean
  - `type` string
  - `name` string
  - `slug` string
  - `link` string
  - `expired` boolean
  - `image_url` string
  - `mobile_image_url` string
  - `home` boolean
  - `stopwatch` string
  - `stopwatch_expires_in` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `start_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `end_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `created_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.
  - `updated_at` BaseTimestamp
    - `date` string — Data e hora no formato YYYY-MM-DD H:MM:SS.
    - `timezone_type` integer — Número de representação do timezone.
    - `timezone` string — Fuso horário associado.

## Other responses

- `400` — Dados inválidos fornecidos
- `422` — Dados inválidos. Pode ocorrer quando campos obrigatórios estão ausentes, o formato é incorreto, ou quando o valor enviado resulta em uma string vazia após sanitização e normalização.

---

[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)