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
- Lee los campos.
GET /api/v1/custom-fieldslista cada clave definida en la organización. - Crea lo que falte.
POST /api/v1/custom-fieldscon unakey, unalabely untype. - Escribe los valores. Envía
customFieldsen Añadir o actualizar un contacto. Una clave que no está definida aquí se rechaza, así que crea primero el campo.