Skip to main content
PATCH
Actualiza uno o más campos de un contacto. Solo envía los campos que quieres modificar.
Los campos no incluidos en la request permanecen sin cambios.

Path Parameters

string
required
UUID del contacto a actualizar

Body Parameters

Todos los campos son opcionales. Solo se actualizan los campos enviados.

Información Básica

string
Nombre completo
string
Email (debe ser válido)
string
URL de imagen de perfil
string
Notas internas

Tags

string[]
Reemplaza todos los tags existentes
string[]
Agrega tags sin eliminar los existentes
string[]
Elimina tags específicos
Si envías tags, se reemplazarán todos los tags. Usa add_tags o remove_tags para modificaciones parciales.

Campos Personalizados

object
Campos personalizados (se fusionan con los existentes)
object
IDs externos (se fusionan con los existentes)

Funnel y Origen

string
UUID de nueva etapa del funnel. Envía null para quitar la etapa.
string
Origen del contacto

Información de Empresa

string
Nombre de empresa
string
Dirección
string
Ciudad
string
Estado/Provincia
string
Código postal
string
Código de país ISO (2 letras)

Asignación de Agente

string | null
UUID del agente humano a asignar. Obtén IDs con GET /team/v1. Envía null para quitar la asignación.Al asignar un agente:
  • Todas las conversaciones activas del contacto se reasignan automáticamente
  • Las conversaciones futuras del contacto también se asignarán a este agente

Ejemplos

Actualizar Nombre y Email

Agregar Tags (sin eliminar existentes)

Actualizar Campos Personalizados

Los custom_fields se fusionan con los existentes. Si el contacto tenía { "company": "Acme" } y envías { "last_purchase": "2026-01-28" }, el resultado será { "company": "Acme", "last_purchase": "2026-01-28" }.

Mover a Nueva Etapa del Funnel

Asignar Agente Humano

Primero lista los agentes disponibles con GET /team/v1 para obtener sus IDs.

Respuesta Exitosa


Errores


Próximos Pasos

Operaciones Masivas

Actualizar múltiples contactos

Eliminar Contacto

Eliminar contacto

Fusionar Contactos

Combinar duplicados

Listar Tags

Ver tags disponibles