Campos personalizados

Lista las definiciones de campos personalizados de la cuenta. Usa los **nombres** (`name`) devueltos aquí como claves del objeto `custom_fields` al crear/actualizar leads.

Base URLhttps://app.syncro.chat/api/v1AuthX-API-Key: crm_SUA_CHAVE_AQUI

Listar campos personalizados

GET/custom-fields

Permiso: custom_fields:read

Parámetros de query

active_onlybooleanopcional

Si es true, devuelve solo campos activos

Tipos de campo (field_type): text, number, currency, date, select, multiselect, checkbox.

Solicitud

curl "https://app.syncro.chat/api/v1/custom-fields?active_only=true" \
  -H "X-API-Key: crm_SUA_CHAVE_AQUI"

Respuesta

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "tamanho_empresa",
      "label": "Tamanho da empresa",
      "field_type": "select",
      "options": [
        "1-10",
        "11-50",
        "51-200",
        "200+"
      ],
      "is_required": false,
      "is_active": true,
      "show_on_card": true,
      "sort_order": 1
    },
    {
      "id": 2,
      "name": "setor",
      "label": "Setor",
      "field_type": "text",
      "options": [],
      "is_required": true,
      "is_active": true,
      "show_on_card": false,
      "sort_order": 2
    }
  ]
}

Enviando valores al crear/actualizar un lead

En POST /leads (y upsert), envía el objeto custom_fields con la clave igual al name del campo:

{
  "name": "João Silva",
  "pipeline_id": 1,
  "stage_id": 5,
  "custom_fields": {
    "tamanho_empresa": "200+",
    "setor": "Tecnologia"
  }
}

Los valores se convierten según el field_type (números, fechas YYYY-MM-DD, booleanos para checkbox, array para multiselect). Las claves que no existen como campo se ignoran.

Ver Leads.