Referencia (endpoints)Campos personalizados

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.

POST
/contacts/attach-custom-field

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:

statusCuándo
201El valor quedó guardado.
404El campo o el contacto no existe, no es de tu cuenta o está fuera del workspace de tu clave. No se guarda.
422value 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.

Autorización

http
headerAuthorizationBearer <clave>

Cuerpo del pedido

application/json
  1. body
[index: integer]?

Cuerpo de la respuesta

OK

application/json
  1. 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  }]

Esto es lo que se copia para tu IA

Cargando…