---
updatedAt: 2025-07-22T10:58:13.000Z
agentTools:
  projectIndex: https://pt-developers.kommo.com/llms.txt
---

# Adicionar grupos de campos

O método permite adicionar grupos de campos de entidade a uma conta

**Limitações**\
O método está disponível apenas para usuários administradores.

**Cabeçalho do tipo de dado quando a solicitação é bem-sucedida**\
Tipo de conteúdo: application/hal+json

**Cabeçalho do tipo de dado em caso de erro**\
Tipo de conteúdo: application/problem+json

**Parâmetros de resposta**\
O método retorna uma coleção de objetos de grupo de campos

| Parâmetro      | Tipo de dado | Descrição                                                                                              |
| :------------- | :----------- | :----------------------------------------------------------------------------------------------------- |
| id             | int          | ID do grupo de campos                                                                                  |
| name           | string       | Nome do grupo de campos                                                                                |
| sort           | string       | Classificação do grupo de campos em um cartão de entidade                                              |
| entity\_type   | int          | Tipo da entidade (leads/contatos/empresas)                                                             |
| is\_predefined | int          | Define se o grupo é o padrão para a entidade. Tais grupos não podem ser excluídos                      |
| type           | string       | Tipo de grupo de campos (`linked_group` – grupos de produtos, `custom_field_group` – grupos de campos) |
| fields         | array        | Um array de IDs de campos do grupo                                                                     |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "referencias-de-api-da-kommo",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://{subdomain}.kommo.com",
      "variables": {
        "subdomain": {
          "default": "subdomain"
        }
      }
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "oauth2",
        "flows": {}
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/api/v4/{entity_type}/custom_fields/groups": {
      "post": {
        "description": "",
        "operationId": "post_apiv4{entity_type}custom_fieldsgroups",
        "responses": {
          "200": {
            "description": ""
          }
        },
        "parameters": [
          {
            "name": "entity_type",
            "in": "path",
            "required": true,
            "description": "Tipo da entidade. Pode ser: leads/contatos/empresas",
            "schema": {
              "type": "string",
              "default": ""
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "RAW_BODY": {
                    "type": "array",
                    "items": {
                      "properties": {
                        "name": {
                          "type": "string",
                          "description": "Nome do grupo de campos"
                        },
                        "sort": {
                          "type": "string",
                          "description": "Classificação do grupo de campos no cartão de entidade"
                        },
                        "request_id": {
                          "type": "string",
                          "description": "Um campo que será retornado a você na resposta sem alterações e não será salvo"
                        }
                      },
                      "type": "object",
                      "required": [
                        "name"
                      ]
                    },
                    "default": ""
                  }
                },
                "type": "object",
                "required": [
                  "RAW_BODY"
                ]
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```