Campos personalizados

Un campo personalizado es un dato que guardas en cada contacto, más allá del email y del nombre: utm_source, plan_tier, signup_date. Se define una sola vez para toda la organización, y cada contacto puede luego llevar un valor para él. Consulta Qué hace un campo personalizado para las reglas que lo rigen. Estas llamadas gestionan las definiciones: la clave, la etiqueta y el tipo. Los valores se escriben en el contacto, con customFields en Añadir o actualizar un contacto.
  • La clave y el tipo se fijan al crear el campo. Solo la etiqueta se puede renombrar. Para cambiar cualquiera de los dos, crea un campo nuevo.
  • Una organización tiene como máximo 50 campos personalizados.
  • Algunas claves están reservadas porque todo contacto ya las tiene (email, first_name, status…) y se rechazan.

El ciclo, de principio a fin

  1. Lee los campos. GET /api/v1/custom-fields lista cada clave definida en la organización.
  2. Crea lo que falte. POST /api/v1/custom-fields con una key, una label y un type.
  3. Escribe los valores. Envía customFields en Añadir o actualizar un contacto. Una clave que no está definida aquí se rechaza, así que crea primero el campo.