Contactos
Listar Campos Personalizados
Obtiene las definiciones de campos personalizados configurados
GET
Obtén la lista de campos personalizados definidos para tu negocio. Estos campos están tipados y estructurados para consistencia en tu CRM.
Los campos personalizados definidos aquí son diferentes de los
custom_fields libres que puedes agregar a cualquier contacto. Estos campos tienen tipos específicos y pueden ser requeridos.Ejemplos
Respuesta Exitosa
Tipos de Campo
| Tipo | Descripción | Ejemplo de valor |
|---|---|---|
text | Texto libre | "Acme Corporation" |
number | Valor numérico | 50000 |
date | Fecha (ISO 8601) | "2026-01-28" |
email | Email válido | "ceo@acme.com" |
phone | Número de teléfono | "+5215512345678" |
url | URL válida | "https://acme.com" |
Campos de la Respuesta
| Campo | Tipo | Descripción |
|---|---|---|
fields | array | Array de definiciones de campos |
fields[].id | string | UUID único del campo |
fields[].name | string | Nombre del campo (snake_case) |
fields[].type | string | Tipo de dato del campo |
fields[].description | string | Descripción del campo |
fields[].is_required | boolean | Si el campo es obligatorio |
fields[].category | string | Categoría para agrupar campos |
total_fields | number | Total de campos definidos |
custom_fields vs Field Definitions
custom_fields (libres)
- Objeto JSON en cada contacto
- Sin tipos definidos
- Flexibilidad total
- Ejemplo:
{ "any_key": "any_value" }
Field Definitions (tipados)
- Definidos a nivel de negocio
- Tipos específicos (text, number, date, etc.)
- Pueden ser requeridos
- Validación automática
Próximos Pasos
Crear Contacto
Usar campos personalizados
Actualizar Contacto
Modificar campos personalizados
Búsqueda Avanzada
Filtrar por campos personalizados
Listar Tags
Ver tags disponibles