HubSpot - Listar objetos

↩ Parte de la integración HubSpot.

Descripción

Lista registros de un tipo de objeto (GET /crm/v3/objects/{object_type}) y devuelve el array results directamente, listo para recorrer, transformar o exportar.

Este nodo no tiene filtros: recorre el tipo de objeto desde el principio, de a una página. Cuando necesitás filtrar por el valor de una propiedad, usá Buscar objetos.

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`
`limit`	number	No	Resultados por página (máx. 100)
`after`	text	No	Cursor de paginación, tomado de `paging.next.after` de la página anterior
`properties`	text	No	Propiedades a devolver, separadas por coma (ej. `email,firstname`)

Todos los campos de texto aceptan variables dinámicas, que es justamente lo que hace posible el bucle de paginación.

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 array de registros (el campo results de la respuesta de HubSpot), no el sobre:

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

El cursor de la página siguiente viaja en _meta:

{ "moduleVersion": "1.0.0", "success": true, "count": 2, "after": "702", "objectType": "contacts", "totalMs": 260 }

Cuando _meta.after viene undefined, no quedan más páginas.

Ejemplo de uso

Primera página de contactos

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "limit": 100,
  "properties": "email,firstname,lastname,lifecyclestage"
}

Página siguiente, guiada por el cursor

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "limit": 100,
  "after": "{{data.after}}",
  "properties": "email,firstname,lastname,lifecyclestage"
}

Empresas para exportar a una planilla

{
  "credentials_id": "hubspot_marketing",
  "object_type": "companies",
  "limit": 100,
  "properties": "name,domain,industry,city"
}

Notas

El tamaño máximo de página es 100 (lo impone HubSpot). Pedir más devuelve un 400.
El nodo trae una página por ejecución. Para recorrer todo el tipo de objeto, realimentá _meta.after en el parámetro after de la iteración siguiente y cortá cuando venga vacío.
Si properties está vacío, HubSpot devuelve solo su propio conjunto de propiedades por defecto, normalmente bastantes menos campos de los que esperás.
La salida es un array, así que un nodo iterador aguas abajo recibe un elemento por registro.
El resultado no viene ordenado ni filtrado. Para “contactos creados en las últimas 24 horas” o “negocios de más de 10.000”, usá Buscar objetos.

Nodos relacionados

HubSpot: Buscar objetos — el mismo array, pero con filtros y orden.
HubSpot: Leer objeto — leé un registro concreto.
HubSpot: Actualizar objeto — actualizá cada registro mientras recorrés la lista.