---
title: "Criar grupo"
description: "POST /v1/catalog/groups — criar um grupo de opções no cardápio BeeFood."
method: "POST"
path: "/v1/catalog/groups"
url: "https://developer.beefood.com.br/docs/catalogo/criar-grupo"
group: "Catálogo"
scope: "catalog:write"
lang: "pt"
---
# Criar grupo

`POST /v1/catalog/groups`

- Produção: `https://api.beefood.app/v1/catalog/groups`
- Sandbox: `https://api-sandbox.beefood.app/v1/catalog/groups`

Cria um grupo.

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `catalog:write`. Limite: 300 requisições a cada 3 minutos.




## Parâmetros do body

- `name` *string* **obrigatório** — Nome do grupo, até 100 caracteres.

- `active` *boolean* — Indica se o grupo está ativo (padrão true).

- `delivery` *boolean* — Indica se o grupo aparece no delivery (padrão true).

- `dineIn` *boolean* — Indica se o grupo aparece no presencial (padrão true).

- `required` *boolean* — Indica se a escolha é obrigatória (padrão false).

- `pizza` *boolean* — Indica se o grupo é de pizza (padrão false).

- `sortOrder` *integer* — Posição de exibição, inteiro maior ou igual a 0 (padrão 0).

- `priceFormation` *string* — Formação de preço (Default: sum): sum, gift, highest ou proportional.

- `minQuantity` *integer* — Quantidade mínima de opções, inteiro maior ou igual a 0 (padrão 0).

- `maxQuantity` *integer* — Quantidade máxima de opções, inteiro maior ou igual a 1 (padrão 1).



## Exemplos de requisição

### cURL

```bash
curl -X POST "https://api.beefood.app/v1/catalog/groups" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Escolha seus Condimentos:",
  "active": true,
  "delivery": true,
  "dineIn": true,
  "required": false,
  "pizza": false,
  "sortOrder": 0,
  "priceFormation": "gift",
  "minQuantity": 0,
  "maxQuantity": 2
}'
```


## Exemplos de resposta

### 201 OK

```json
{
  "groupId": 264010,
  "name": "Escolha seus Condimentos:",
  "active": true,
  "delivery": true,
  "dineIn": true,
  "required": false,
  "pizza": false,
  "sortOrder": 0,
  "priceFormation": "gift",
  "minQuantity": 0,
  "maxQuantity": 2,
  "products": []
}
```


## Campos da resposta

- `groupId` *number* — Identificador do grupo.

- `name` *string* — Nome do grupo.

- `active` *boolean* — Indica se o grupo está ativo.

- `delivery` *boolean* — Indica se o grupo aparece no delivery.

- `dineIn` *boolean* — Indica se o grupo aparece no presencial.

- `required` *boolean* — Indica se a escolha é obrigatória.

- `pizza` *boolean* — Indica se o grupo é de pizza.

- `sortOrder` *number* — Posição de exibição.

- `priceFormation` *string* — Formação de preço: sum, gift, highest ou proportional.

- `minQuantity` *number* — Quantidade mínima de opções.

- `maxQuantity` *number* — Quantidade máxima de opções.

- `products` *array* — Produtos vinculados ao grupo.

- `products[].productId` *number* — Identificador do produto.

- `products[].name` *string* — Nome do produto.

- `products[].image` *object* — URLs da imagem do produto.

- `products[].image.original` *string* — Imagem original.

- `products[].image.thumbnail60` *string* — Miniatura de 60 px.

- `products[].image.thumbnail120` *string* — Miniatura de 120 px.

- `products[].image.thumbnailWeb` *string* — Miniatura para web.



## Erros

| Status | Mensagem |
| --- | --- |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the catalog:write scope |
| 429 | Too many requests |
| 400 | Invalid group data |