---
title: "Actualizar un campo personalizado"
method: PATCH
path: "/api/v4/{entity}/custom_fields/{id}"
---

# Actualizar un campo personalizado

`PATCH /api/v4/{entity}/custom_fields/{id}`

Este método permite actualizar un campo personalizado singular de una entidad (leads/contactos/compañías).

## Path parameters

- `entity_type` 'leads' | 'contacts' | 'companies', required
- `id` integer, required

## Request body

- object
  - `name` string — Nombre del campo
  - `code` string — Código del campo que se puede utilizar para actualizar el valor del campo sin pasar el ID del campo en la solicitud
  - `sort` integer — Ordenación de los campos en el grupo de campos
  - `group_id` integer — ID del grupo de campos
  - `is_api_only` boolean — Define si el campo es editable solo a través de la API. Disponible para todos los campos de leads, contactos y compañías
  - `required_statuses` object[] — Arreglo de los campos requeridos para cambiar el estado de un lead
    - `status_id` integer — ID de la etapa que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido
    - `pipeline_id` integer — ID del pipeline que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido
  - `remind` string — Disponible solo para los campos de tipo cumpleaños. Configuración de recordatorios de cumpleaños (nunca, mismo día, día antes del evento)
  - `enums` object[] — Disponible y obligatorio para los siguientes tipos de campo: `select`/`multiselect`/`radiobutton`
    - `id` integer — Debes proporcionar el ID si deseas actualizar el campo sin eliminar los valores de enumeración existentes. Si no proporcionas este campo, los valores de enumeración existentes se eliminarán.
    - `value` string — Valor
    - `sort` integer — Ordenación de los valores
    - `code` string — Código simbólico del valor

## Response `200`

200

- object
  - `id` integer
  - `name` string
  - `type` string
  - `account_id` integer
  - `code` string
  - `sort` integer
  - `is_api_only` boolean
  - `enums` unknown
  - `request_id` string
  - `catalog_id` integer
  - `is_visible` boolean
  - `is_deletable` boolean
  - `is_required` boolean
  - `nested` unknown
  - `entity_type` string
  - `_links` object
    - `self` object
      - `href` string

## Other responses

- `400` — 400
- `401` — 401
- `422` — 422

---

[API](https://skmtc.net/kommo/apis/kommo-api.md) · [All operations](https://skmtc.net/kommo/apis/kommo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kommo/kommo-api/versions/e291c0b2038d/schema)