---
title: "Criar marca"
method: POST
path: "/{alias}/catalog/brands"
tags: ["Catálogo - Marcas"]
---

# Criar marca

`POST /{alias}/catalog/brands`

Cria uma nova marca no catálogo

## Path parameters

- `alias` string, required

## Request body

- BrandRequest — Dados para criação ou atualização de uma marca
  - `name` string, required — Nome da marca. Esse valor deve ser único. O valor é sanitizado e normalizado automaticamente.
  - `active` boolean, required — Se a marca está ativo
  - `featured` boolean, required
  - `description` string — Descrição da marca. O valor é sanitizado e normalizado automaticamente.
  - `logo_url` string, uri — URL do logo da marca

## Response `201`

Marca criada com sucesso

- object
  - `data` Brand — Representa uma marca do catálogo
    - `id` integer
    - `active` boolean
    - `featured` boolean
    - `name` string
    - `description` string
    - `logo_url` string, url

## Other responses

- `400` — Requisição inválida
- `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)