post
https://{subdominio}.kommo.com/api/v4//custom_fields
Este método permite añadir uno o varios campos personalizados a una entidad (leads, compañías, contactos).
Limitaciones
El método está disponible solo para usuarios administradores.
Encabezado de tipo de datos cuando la solicitud es exitosa
Content-Type: application/hal+json
Encabezado de tipo de datos en caso de un error
Content-Type: application/problem+json
Parámetros de respuesta
Para añadir un campo personalizado, se debe pasar un objeto campo.
| Parámetro | Tipo de dato | Descripción | ¿Es el campo obligatorio? | Tipos de campos admitidos |
|---|---|---|---|---|
| type | string | Tipo de campo. | ✅ | Disponible para todos los tipos de campo. |
| name | string | Nombre del campo. | ✅ | Disponible para todos los tipos de 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. | ❌ | Disponible para todos los tipos de campo. |
| sort | int | Ordenación de los campos en el grupo de campos. | ❌ | Disponible para todos los tipos de campo. |
| group_id | string | ID del grupo de campos. | ❌ | Disponible para todos los campos de leads, contactos y compañías. |
| is_api_only | bool | 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 | array|null | Arreglo de los campos requeridos para cambiar el estado de un lead. | ❌ | Disponible para todos los campos de leads, contactos y compañías. |
| required_statuses[0] | object | Modelo del campo disponible. | ❌ | Disponible para todos los campos de leads, contactos y compañías. |
| required_statuses[0][status_id] | int | ID de la etapa que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido. | ❌ | Disponible para todos los campos de leads, contactos y compañías. |
| required_statuses[0][pipeline_id] | int | ID del pipeline que requiere que el campo actual tenga un valor antes de que el lead pueda ser movido. | ❌ | Disponible para todos los campos de leads, contactos y compañías. |
| remind | string|null | Configuración de recordatorios de cumpleaños (nunca, día – día antes del evento, semana – semana antes del evento, mes – mes antes del evento). | ❌ | Disponible solo para los campos de tipo cumpleaños. |
| enums | array | Arreglo de valores disponibles para el campo. | ✅ | Disponible para los siguientes tipos de campo:: -multiselección -botón de radio -seleccionar |
| enums[0] | object | Modelo de valor disponible para el campo. | ✅ | Disponible para los siguientes tipos de campo:: -multiselección -botón de radio -seleccionar |
| enums[0][value] | string | Valor. | ✅ | Disponible para los siguientes tipos de campo:: -multiselección -botón de radio -seleccionar |
| enums[0][sort] | string | Ordenación de valores. | ✅ | Disponible para los siguientes tipos de campo:: -multiselección -botón de radio -seleccionar |