HubSpot

Descripción

Los nodos HubSpot conectan tus workflows con HubSpot a través de su API de CRM v3. Con ellos podés automatizar tu CRM: crear un contacto cuando entra un lead, actualizar un negocio al avanzar el pipeline, buscar contactos por email, o listar empresas para procesarlas.

Hay seis nodos, uno por operación:

Nodo	Operación	Método HTTP
HubSpot: Crear objeto (hubspotCreateObject)	Crea un objeto	POST /crm/v3/objects/{object_type}
HubSpot: Leer objeto (hubspotGetObject)	Lee un objeto por su id	GET /crm/v3/objects/{object_type}/{id}
HubSpot: Actualizar objeto (hubspotUpdateObject)	Actualiza propiedades	PATCH /crm/v3/objects/{object_type}/{id}
HubSpot: Borrar objeto (hubspotDeleteObject)	Archiva un objeto	DELETE /crm/v3/objects/{object_type}/{id}
HubSpot: Buscar objetos (hubspotSearchObjects)	Busca con filtros	POST /crm/v3/objects/{object_type}/search
HubSpot: Listar objetos (hubspotListObjects)	Lista objetos	GET /crm/v3/objects/{object_type}

Credencial

Los nodos usan una credencial de tipo HubSpot. Creala en Credenciales → Agregar → HubSpot con este campo:

Campo	Descripción
Private App token	El token de la Private App, desde HubSpot → Settings → Integrations → Private Apps (empieza con pat-). Nunca se muestra en logs.

La autenticación de HubSpot envía el token en el header Authorization con el prefijo Bearer. Podés probar la credencial con el botón Test, que llama a GET /crm/v3/objects/contacts?limit=1.

Nota importante: propiedades y tipos de objeto

• Las propiedades (properties) son un mapa plano, no anidado. Por ejemplo: {"email":"a@b.com","firstname":"Ana"}. Los nombres de propiedad son los internos de HubSpot (firstname, lastname, email, phone, dealname, amount, subject…).
• Los tipos de objeto (object_type) genéricos del CRM son: contacts, companies, deals y tickets.
• Borrar archiva: hubspotDeleteObject no elimina definitivamente, archiva el objeto (queda recuperable desde HubSpot). El nodo devuelve { "archived": true, "id": ... }.
• Los objetos se referencian por id. También podés usar el id de una propiedad única (ej. email de un contacto) según la configuración de HubSpot.

Nodos

HubSpot: Crear objeto (hubspotCreateObject)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto (contacts, companies, deals, tickets)
properties	JSON	Sí	Mapa plano de propiedades, ej. {"email":"a@b.com"}

Salida: el objeto creado, incluyendo su id y properties.

HubSpot: Leer objeto (hubspotGetObject)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto
object_id	texto	Sí	id del objeto
properties	texto	No	Propiedades a devolver, separadas por coma (ej. email,firstname)

HubSpot: Actualizar objeto (hubspotUpdateObject)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto
object_id	texto	Sí	id del objeto
properties	JSON	Sí	Propiedades a actualizar, ej. {"firstname":"Ana"}

HubSpot: Borrar objeto (hubspotDeleteObject)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto
object_id	texto	Sí	id del objeto a archivar

HubSpot: Buscar objetos (hubspotSearchObjects)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto
search	JSON	Sí	Cuerpo de búsqueda: filterGroups, query, sorts, properties, limit

Salida: el array results con los objetos que coinciden.

HubSpot: Listar objetos (hubspotListObjects)

Parámetro	Tipo	Requerido	Descripción
credentials_id	credencial	Sí	Credencial de HubSpot
object_type	texto	Sí	Tipo de objeto
limit	número	No	Resultados por página (máx. 100)
after	texto	No	Cursor de paginación (paging.next.after)
properties	texto	No	Propiedades a devolver, separadas por coma

Salida: el array results de objetos.

Ejemplo

Crear un contacto a partir de un formulario:

• Nodo: HubSpot: Crear objeto
• object_type: contacts
• properties: {"email":"{{data.email}}","firstname":"{{data.nombre}}","phone":"{{data.telefono}}"}

Salida:

{
  "id": "701",
  "properties": {
    "email": "ana@acme.com",
    "firstname": "Ana",
    "createdate": "2026-08-05T10:00:00.000Z"
  },
  "createdAt": "2026-08-05T10:00:00.000Z",
  "archived": false
}

Buscar contactos por email:

• Nodo: HubSpot: Buscar objetos
• object_type: contacts
• search: {"filterGroups":[{"filters":[{"propertyName":"email","operator":"EQ","value":"ana@acme.com"}]}],"properties":["email","firstname"],"limit":10}

Manejo de errores

Cada nodo clasifica los errores para que el motor sepa si tiene sentido reintentar:

Situación	Reintentable	Qué hacer
Validación (400/409)	No	HubSpot devuelve el message y la category (ej. propiedad inexistente, o contacto duplicado). Corregí los datos.
No encontrado (404)	No	El objeto o el tipo no existen. Revisá el id y el object_type.
Autenticación (401/403)	No	Token inválido o sin los scopes necesarios en la Private App. Revisá la credencial.
Servidor (500)	Sí	Error temporal de HubSpot; se reintenta automáticamente.
Límite de tasa (429)	Sí	Se respeta el Retry-After de HubSpot y se reintenta.
Red / Timeout	Sí	Problema pasajero; se reintenta automáticamente.

Los errores de validación no se reintentan

Un dato mal cargado no se reintenta: reintentar con lo mismo solo repetiría el fallo. Corregí la entrada y volvé a ejecutar. Podés ver los reintentos automáticos en el panel de Reintentos (DLQ).

Ver también

• Jira (Atlassian), Asana, Trello, Notion y ClickUp — otras integraciones de gestión de trabajo y CRM.
• Cola de reintentos (DLQ) — cómo se reintentan las ejecuciones que fallan.
• Nodo HTTP — para endpoints de HubSpot no cubiertos por estos nodos (associations, pipelines, properties…).