HubSpot - Leer objeto

↩ Parte de la integración HubSpot.

Descripción

Lee un único registro del CRM de HubSpot por su id (GET /crm/v3/objects/{object_type}/{id}).

Por defecto HubSpot devuelve solo un conjunto reducido de propiedades. Con el parámetro properties nombrás exactamente las que necesita tu flujo: el payload queda más chico y los nodos siguientes son más fáciles de escribir.

Configuración

Campo	Tipo	Obligatorio	Descripción
`credentials_id`	credentials	Sí	Credencial de HubSpot
`object_type`	text	Sí	Tipo de objeto: `contacts`, `companies`, `deals`, `tickets`. Si lo dejás vacío se usa `contacts`
`object_id`	text	Sí	Id del objeto a leer
`properties`	text	No	Propiedades a devolver, separadas por coma (ej. `email,firstname`)

Los tres campos de texto aceptan variables dinámicas, así que object_id suele ser {{data.id}} proveniente de un nodo anterior.

Credenciales

Este módulo necesita una credencial de HubSpot:

Campo	Descripción
`token`	Token de la Private App (empieza con `pat-`), desde HubSpot → Settings → Integrations → Private Apps

Salida

data es el objeto de HubSpot:

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

Junto con él, _meta:

{ "moduleVersion": "1.0.0", "success": true, "id": "701", "objectType": "contacts", "totalMs": 180 }

Ejemplo de uso

Leer un contacto con propiedades elegidas

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "object_id": "{{data.contactId}}",
  "properties": "email,firstname,lastname,phone,lifecyclestage"
}

Leer el negocio que disparó el flujo

{
  "credentials_id": "hubspot_ventas",
  "object_type": "deals",
  "object_id": "{{data.objectId}}",
  "properties": "dealname,amount,dealstage,closedate"
}

Leer una empresa con las propiedades por defecto

{
  "credentials_id": "hubspot_marketing",
  "object_type": "companies",
  "object_id": "8912345678"
}

Notas

Los valores de properties son nombres internos de propiedad separados por coma. Lo que no sea una propiedad real HubSpot lo ignora en lugar de dar error, así que un typo aparece como un campo que falta en la salida.
Si object_id se resuelve a un valor vacío, el nodo se detiene con un error de validación antes de llamar a HubSpot.
Un id inexistente devuelve 404 y ese error no se reintenta. Si no estás seguro de que el registro exista, usá antes Buscar objetos.
Este endpoint no devuelve registros archivados.
Lo que se lee acá es un único objeto. Para leer varios de una vez usá Listar objetos o Buscar objetos, que devuelven arrays.

Nodos relacionados

HubSpot: Buscar objetos — encontrá el id cuando solo tenés un email o un nombre.
HubSpot: Actualizar objeto — modificá el registro que acabás de leer.
HubSpot: Listar objetos — recorré muchos registros en vez de uno.