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

`POST /v1/catalog/sectors`

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

Cria um setor.

## 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 setor, até 150 caracteres. Exemplo: `Sobremesas`.

- `publicName` *string* — Nome exibido no cardápio digital, até 150 caracteres. Exemplo: `Doces`.

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

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



## Exemplos de requisição

### cURL

```bash
curl -X POST "https://api.beefood.app/v1/catalog/sectors" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Sobremesas",
  "publicName": "Doces",
  "delivery": true,
  "dineIn": true
}'
```


## Exemplos de resposta

### 201 OK

```json
{
  "sectorId": 221160,
  "storeId": 107,
  "name": "Sobremesas",
  "publicName": "Doces",
  "delivery": true,
  "dineIn": true,
  "menus": [
    {
      "merchantId": 122,
      "name": "Restaurante Exemplo",
      "active": true
    }
  ]
}
```


## Campos da resposta

- `sectorId` *number* — Identificador do setor.

- `storeId` *number* — Identificador da empresa.

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

- `publicName` *string* — Nome exibido no cardápio digital.

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

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

- `image` *object* — URLs da imagem do setor. Somente leitura. Para enviar ou remover, use Enviar imagem e Remover imagem com resourceType = sectors.

- `image.original` *string* — Imagem original.

- `image.thumbnail80` *string* — Miniatura de 80 px.

- `image.thumbnail180` *string* — Miniatura de 180 px.

- `menus` *array* — Cardápios do setor.

- `menus[].merchantId` *number* — Identificador do cardápio.

- `menus[].name` *string* — Nome do cardápio.

- `menus[].active` *boolean* — Indica se o setor está ativo no cardápio.

- `menus[].sortOrder` *number* — Posição do setor no cardápio.



## 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 sector data |