Poner un valor en un contacto
Úsalo para guardar datos propios de tu negocio en los contactos (plan, ciudad, fecha de compra): asigna valores de campos personalizados a uno o varios contactos en una sola llamada.
Permiso requerido: Contactos y conversaciones → Editar
Pone valores de campos personalizados en contactos. El cuerpo es una lista de ítems {customFieldId, contactId, value}; si el contacto ya tenía un valor en ese campo, se reemplaza.
[{"customFieldId": 15, "contactId": 4321, "value": "2026-11-30"}]Cada ítem se resuelve por separado y uno rechazado no detiene a los demás. La respuesta es 200 con un resultado {message, status} por ítem, en el mismo orden:
status | Cuándo |
|---|---|
| 201 | El valor quedó guardado. |
| 404 | El campo o el contacto no existe, no es de tu cuenta o está fuera del workspace de tu clave. No se guarda. |
| 422 | value no cumple el formato del tipo del campo (numérico, fecha AAAA-MM-DD o URL); message dice qué formato espera. No se guarda. |
Cómo escribir value según el tipo: ver type en GET /custom-fields. Si el cuerpo no es una lista de ítems con customFieldId, contactId y value de texto, la llamada entera responde 422 y no guarda nada.
httpAuthorizationBearer <clave>application/json- body
[index: integer]?OK
application/json- response
[index: integer]?curl -X POST "https://example.com/contacts/attach-custom-field" \ -H "Content-Type: application/json" \ -d '[ { "customFieldId": "fld_Ar7McDNiFfizqFzTybtrwHL", "contactId": "ctc_AAOzYSKDiqHT4hM8LdPB8Ut", "value": "string" } ]'[ { "message": "string", "status": 0 }]Ver los campos de un contacto GET
Sirve para leer los valores de los campos personalizados de un contacto, con búsqueda por nombre de campo.
Quitar un valor de un contacto POST
Sirve para borrar el valor de un campo personalizado en uno o varios contactos, por ejemplo cuando un dato quedó desactualizado en tu sistema.