---
title: "Cadastrar categoria"
method: POST
path: "/categorias"
tags: ["Categorias"]
---

# Cadastrar categoria

`POST /categorias`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/categorias`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Método utilizado para inserir novas categorias no sistema. Caso já
exista uma categoria com a mesma descrição da que está sendo inserida,
será retornado apenas o **Id** da categoria existente com status 200,
pois não deve existir duas categorias com a mesma descrição. Caso a
categoria não exista, ao criá-la também retornará o **Id**, porém o
status retornado será **201**.

## Request body

- CategoriaCreate
  - `nome` string, required: Nome da categoria (deve ser único).
  - `imagem` string: Imagem da categoria. Pode ser enviada em base64 ou via URL.
  - `codigo` string: Código da categoria. Pode ser usado para buscar, listar ou atualizar categorias no lugar do Id.

## Response `200`

Já existia uma categoria com a mesma descrição. Retornado o ID da existente.

- IdResponse
  - `id` string

## Other responses

- `201`: Categoria criada com sucesso.
- `400`: Erro na requisição que não foi possível ser completada. O erro é retornado em uma string (não JSON).
- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)