🇪🇸 Español 🇬🇧 English 🇧🇷 Português

Nodo: Crear/actualizar contacto en HubSpot

Cómo usar el nodo que sincroniza contactos con HubSpot por email desde tus workflows o automatizaciones de tablero.

Jul 11, 2026

El nodo Crear/actualizar contacto en HubSpot sincroniza un contacto con tu cuenta de HubSpot conectada, usando el email como clave: si ya existe un contacto con ese email lo actualiza, si no existe lo crea. Está disponible tanto en la automatización de Tableros (Proyectos) como en Workflows.

Cuándo usarlo

  • Cuando una tarjeta de Proyectos pasa a "Hecho"/"Ganado" y querés reflejar el cliente en HubSpot.
  • Cuando una oportunidad del CRM se cierra y necesitás mantener sincronizado tu HubSpot externo.
  • Como paso de una campaña omnicanal que también alimenta HubSpot para marketing.

Requisitos

  • Tener una integración de HubSpot conectada y activa en el workspace (Configuración → Integraciones). Si no hay integración activa, el nodo falla suave (rama error) y no rompe el workflow.
  • Un email válido para el contacto — es el dato obligatorio y la clave del upsert.

Configuración

  • Email (obligatorio): clave de búsqueda/creación.
  • Nombre (firstname), Apellido (lastname), Teléfono (phone), Empresa (company): opcionales, se envían solo si están completos.

Ejemplo

Automatización de tablero "Ventas": cuando una tarjeta se mueve al grupo "Ganado" → nodo Crear/actualizar contacto en HubSpot con email={{$deal.contact.email}}, firstname={{$deal.contact.first_name}}, company={{$deal.company.name}}.

Consejos

  • El upsert es por email: dos contactos con el mismo email en HubSpot se tratan como el mismo registro.
  • El nodo actualiza la fecha de última sincronización de la integración cada vez que corre con éxito.

Solución de problemas

  • "No hay una integración de HubSpot conectada": conectá HubSpot en Configuración → Integraciones.
  • "Falta el email del contacto": el campo email llegó vacío; revisá la variable que estás usando.
  • Error "HubSpot search/upsert failed": suele ser un problema de permisos (scopes) de la app conectada en HubSpot; reconectá la integración.
¿Te fue útil?

Artículos relacionados