Integración HubSpot n8nAutomatiza HubSpot con n8n.

Crea la ficha de empresa en HubSpot y devuelve su identificador, que reutilizas en los pasos siguientes del flujo.

• Name: el nombre de la empresa, el único campo obligatorio, a menudo una expresión n8n como {{ $json.company }} que recupera el valor del nodo anterior.
• Company Properties: la colección opcional de 34 propiedades, con Website URL, la propiedad que HubSpot usa para identificar empresas únicas, y Company Owner Name or ID para asignar responsable.

Borra una empresa del CRM. El único dato que pide es el registro a eliminar, y la elección se hace antes, normalmente con una búsqueda por dominio.

• Company to Delete: el selector que apunta a la empresa. La eliges de la lista del portal o pasas su identificador con una expresión, por ejemplo {{ $json.companyId }}.

Recupera una empresa concreta con sus propiedades. Es el paso previo típico cuando el flujo tiene que decidir algo a partir del estado de la cuenta.

• Company to Get: la empresa que quieres leer, elegida de la lista o resuelta con una expresión.
• Include Merge Audits: desactivado por defecto. Activado, devuelve el histórico de fusiones si esa empresa se fusionó antes con otro registro.

Trae la lista de empresas del portal, encadenando las páginas de la API por ti.

• Return All: activado, n8n recorre todas las páginas y devuelve todas las empresas; desactivado, se detiene en el número que fijes en Limit.
• Company Properties to Include: elige qué propiedades bajan con cada empresa, para no arrastrar el registro completo cuando solo necesitas el nombre y el dominio.
• Include Merge Audits: añade el historial de fusiones de las empresas que lo tengan.

Se queda con las empresas creadas o modificadas hace poco, en lugar de recorrer el portal entero en cada ejecución.

• Since: la fecha a partir de la cual cuentan los cambios. Con expresiones, la hora se escribe en formato YYYY-MM-DD hh-mm-ss.
• Return All y Limit: activado, bajan todas las empresas creadas o modificadas desde Since; desactivado, el nodo se queda en las primeras que fijes.
• Company Properties to Include: las propiedades que quieres ver en el resultado.

Busca en el portal las empresas cuyo dominio web coincide con el que le pasas, y devuelve la ficha si ya existe.

• Domain: obligatorio, el dominio del sitio de la empresa, del tipo n8n.io. Suele venir del email del lead, ya recortado en el nodo anterior.
• Return All y Limit: útiles cuando varias fichas comparten dominio.
• Company Properties to Include: las propiedades que acompañan a cada resultado.

Modifica una empresa existente sin tocar las propiedades que no menciones en la llamada.

• Company to Update: el registro que se va a modificar.
• Update Fields: los 35 campos disponibles, entre ellos Name, Lifecycle Stage Name or ID, Annual Revenue, Number Of Employees y Custom Properties para las propiedades que hayas creado tú.

Una sola operación cubre los dos casos: si el email ya existe en el portal, actualiza la ficha; si no, la crea. Así entran los leads sin duplicados.

• Email: obligatorio, del tipo name@email.com. Es la clave que decide entre crear y actualizar.
• Contact Properties: 67 propiedades, entre ellas First Name, Job Title, Lifecycle Stage Name or ID y Associated Company Name or ID, que cuelga el contacto de su empresa.
• Simplify Output: sin esta opción la respuesta solo trae el identificador; activada, el nodo resuelve los datos del contacto.

Elimina un contacto del CRM de forma definitiva. Conviene encadenarla detrás de un paso de confirmación, porque no hay vuelta atrás desde el flujo de trabajo.

• Contact to Delete: el identificador del contacto, un número como 1485, y no su dirección de correo. Para llegar hasta él partiendo de un email, pasa antes por la operación Search.

Lee un contacto concreto. Por defecto la respuesta se limita al identificador: sin una lista de propiedades, el flujo recibe un número y poco más.

• Contact to Get: el número del contacto, no su email.
• Contact Properties to Include: las propiedades que quieres en el resultado, una por una.
• Include List Memberships: añade las listas a las que pertenece el contacto.
• Form Submission Mode: define qué envíos de formulario bajan con la ficha, todos, ninguno, solo el más reciente o solo el más antiguo.

Pagina la base de contactos entera, con el mismo mecanismo que el resto de lecturas del nodo.

• Return All: activado, trae todos los contactos; desactivado, se queda en Limit.
• Contact Properties to Include: sin esta lista, cada contacto llega reducido a su identificador.
• Include List Memberships: devuelve las listas a las que pertenece cada contacto, útil cuando el flujo tiene que saber quién ya está en la lista de clientes.

Devuelve solo los contactos tocados recientemente, creados o modificados, para no releer toda la base en cada pasada.

• Return All y Limit: activado, llegan todas las fichas tocadas desde la última pasada; desactivado, solo las primeras del lote.
• Contact Properties to Include: las propiedades que bajan con cada contacto.
• Include List Memberships y Form Submission Mode: listas y envíos de formulario, cuando el proceso posterior los necesita.

Filtra la base con condiciones combinadas y devuelve solo lo que encaja, en vez de traerlo todo y descartar después.

• Filter Groups: dentro de un grupo, los filtros se combinan con AND; entre grupos, con OR. El sistema admite como máximo tres grupos de tres filtros cada uno.
• Query: búsqueda de texto sobre todos los valores de propiedad del objeto.
• Sort By y Sort Order: el campo de ordenación y su dirección, descendente por defecto.
• Return All y Limit: todos los contactos que encajan con los filtros, o solo los primeros de la lista de resultados.

Mete un contacto en una lista de HubSpot. Es el paso que suele faltar cuando el lead ya está creado pero nadie lo inscribe en la secuencia. La credencial necesita el scope crm.lists.write.

• By: eliges cómo identificas al contacto, por Contact ID o por Email. Ese valor decide cuál de los dos campos siguientes rellenas.
• Email: la dirección del contacto, del tipo name@email.com. Es el campo de la opción Email.
• Contact to Add: el identificador numérico del contacto, el campo de la opción Contact ID.
• List to Add To: el número de la lista de destino.

Saca a un contacto de una lista. Sirve para que alguien deje de recibir una secuencia en cuanto su situación cambia, sin esperar a la limpieza manual del viernes.

• Contact to Remove: el identificador numérico del contacto.
• List to Remove From: el número de la lista de la que sale.

Abre un negocio en el pipeline y lo coloca directamente en la etapa que le indiques.

• Deal Stage Name or ID: obligatorio, HubSpot exige la etapa al crear el negocio. La eliges de la lista o pasas su identificador con una expresión.
• Deal Properties: los 10 campos opcionales, con Deal Name, Amount, Close Date, Pipeline Name or ID, Deal Owner para el usuario asignado y Associated Company Names or IDs para atarlo a su cuenta.

Quita un negocio del pipeline. La operación se limita a eso, así que la decisión de borrar se toma antes, en el nodo que la precede.

• Deal to Delete: el negocio que se elimina, elegido de la lista o resuelto con una expresión desde el nodo anterior.

Lee un negocio concreto. Igual que en contactos, el resultado se queda en el identificador mientras no pidas propiedades.

• Deal to Get: el negocio que quieres leer.
• Deal Properties to Include: las propiedades que acompañan al resultado, importe y etapa entre ellas.
• Include Property Versions: por defecto solo llega la versión más reciente de cada propiedad; activado, también las anteriores.

Recorre los negocios del portal, con o sin sus asociaciones.

• Return All y Limit: todo el pipeline, o los primeros negocios.
• Include Associations: devuelve los identificadores de los contactos y las empresas asociados, y añade la propiedad num_associated_contacts.
• Deal Properties to Include y Deal Properties with History to Include: las propiedades del resultado, con su historial en el segundo caso.

Devuelve los negocios movidos últimamente, creados o modificados desde la fecha que marques.

• Since: el punto de partida del periodo. Con expresiones, la hora va en formato YYYY-MM-DD hh-mm-ss.
• Return All y Limit: todos los negocios movidos desde esa fecha, o solo un primer lote del tamaño que marques.
• Include Property Versions: añade las versiones anteriores de cada propiedad, útil para ver de dónde venía un importe.

Consulta el pipeline con filtros del lado de HubSpot, en lugar de traerlo entero y filtrar después en n8n.

• Filter Groups: AND dentro de cada grupo, OR entre grupos, con un tope de tres grupos y tres filtros por grupo.
• Filters: las condiciones sobre los valores de propiedad de los negocios.
• Query: búsqueda de texto sobre todos los valores de propiedad.
• Sort By y Direction: ordenación del resultado, descendente por defecto.

Cambia las propiedades de un negocio ya abierto, incluida su etapa, sin tocar el resto de la ficha.

• Deal to Update: el negocio que se modifica.
• Update Fields: los 9 campos disponibles, con Deal Stage Name or ID, Amount, Close Date, Deal Owner, Pipeline y Custom Properties.

Una actividad de HubSpot, lo que el nodo llama engagement, guarda lo que ha pasado con un contacto o una empresa. Esta operación la crea desde el flujo de trabajo.

• Type: el tipo de actividad: call, email, meeting o task. Único campo obligatorio.
• Metadata: el contenido de la actividad. Subject y Body llevan el texto, Status marca el avance (IN_PROGRESS, COMPLETED) y For Object Type dice si cuelga de CONTACT o de COMPANY.
• Associations: engancha la actividad a los registros ya existentes.

Borra una actividad concreta del registro al que está asociada. La llamada, el correo o la tarea dejan de aparecer en la ficha del contacto o de la empresa.

• Engagement to Delete: el selector de la actividad. Eliges el engagement en la lista que carga n8n o pasas su identificador con una expresión desde el nodo anterior.

Devuelve una sola actividad a partir de su identificador, con las propiedades tal y como están guardadas en HubSpot. Es la operación de lectura previa a cualquier decisión del flujo de trabajo.

• Engagement to Get: la actividad que quieres leer, seleccionada en la lista del campo o indicada por su identificador mediante una expresión.

Recorre las actividades de la cuenta y las devuelve una por ítem: cada llamada, cada correo, cada reunión y cada tarea sale por separado, lista para tratarla en bloque.

• Return All: activado, n8n encadena las páginas de la API y trae todas las actividades; desactivado, se queda en el número fijado por Limit.
• Limit: el número máximo de actividades que devuelve el nodo cuando Return All está desactivado.

Abre un ticket de soporte en HubSpot y lo coloca ya en la etapa que le toca.

• Pipeline Name or ID: el pipeline donde vive el ticket, elegido en la lista o indicado con una expresión.
• Stage Name or ID: la etapa dentro de ese pipeline. Sus opciones dependen del pipeline, así que rellena antes el campo anterior.
• Ticket Name: el título que lee el equipo en la lista.
• Ticket Properties: la colección opcional, con Description, Priority Name or ID y Ticket Owner Name or ID, quien se hace cargo.

¿Un ticket creado por error? Esta operación lo elimina de HubSpot. Actúa sobre el registro entero, no sobre una de sus propiedades: para cambiar solo el estado, la operación es Update.

• Ticket to Delete: el ticket sobre el que actúa el nodo. Lo eliges en la lista o lo apuntas por su identificador con una expresión.

Trae un ticket concreto, con las propiedades que le pidas y nada más. Encaja cuando el flujo de trabajo necesita el estado real antes de responder.

• Ticket to Get: el ticket que se lee, seleccionado en la lista o indicado por su identificador.
• Ticket Properties to Include: acota la respuesta a las propiedades del ticket que elijas.
• Properties With History: mismo principio, pero con el historial de cambios de la propiedad en lugar de su valor actual.
• Include Deleted: incluye también los tickets eliminados.

Lista los tickets de la cuenta, uno por ítem, para tratarlos en lote en el resto del flujo de trabajo.

• Return All: marcado, el nodo pasa por todas las páginas de la API hasta devolver todos los tickets; sin marcar, se detiene en Limit.
• Limit: el tope de tickets devueltos en una ejecución.
• Ticket Properties to Include: reduce cada ticket a las propiedades que necesitas, cómodo cuando el lote es grande.
• Properties With History: añade el historial de una propiedad, útil para ver cómo ha ido cambiando de etapa.

Modifica un ticket que ya existe. Rellena en Update Fields únicamente las propiedades que quieras cambiar.

• Ticket to Update: el ticket destino, elegido en la lista o apuntado con una expresión desde el nodo anterior.
• Update Fields: la colección de cambios. Dentro están Stage Name or ID para mover el ticket de etapa, Resolution Name or ID para dejar escrito cómo se ha resuelto, Ticket Name para reescribir el título y Close Date, que en una expresión espera el formato YYYY-MM-DD hh-mm-ss.