HubSpot - Actualizar objeto

↩ Parte de la integración HubSpot.

Descripción

Actualiza un registro existente de HubSpot (PATCH /crm/v3/objects/{object_type}/{id}).

La llamada es una actualización parcial: solo se modifican las propiedades que enviás y el resto queda intacto. Eso la hace segura para ejecutarla en cada corrida: mover un negocio a la etapa siguiente, sellar la fecha del último pedido en un contacto o cerrar un ticket.

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 actualizar
`properties`	json	Sí	Propiedades a actualizar, ej. `{"firstname":"Ana"}`

object_type, object_id y properties aceptan variables dinámicas; el texto de properties se resuelve antes de parsearse como JSON.

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 actualizado tal como lo devuelve HubSpot:

{
  "id": "701",
  "properties": {
    "firstname": "Ana",
    "lifecyclestage": "customer",
    "lastmodifieddate": "2026-08-05T12:05:00.000Z",
    "hs_object_id": "701"
  },
  "createdAt": "2026-08-05T10:00:00.000Z",
  "updatedAt": "2026-08-05T12:05:00.000Z",
  "archived": false
}

Junto con él, _meta:

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

Ejemplo de uso

Promover un contacto a cliente

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "object_id": "{{data.contactId}}",
  "properties": { "lifecyclestage": "customer", "phone": "{{data.telefono}}" }
}

Mover un negocio a la siguiente etapa

{
  "credentials_id": "hubspot_ventas",
  "object_type": "deals",
  "object_id": "{{data.dealId}}",
  "properties": { "dealstage": "contractsent", "amount": "{{data.total}}" }
}

Cerrar un ticket

{
  "credentials_id": "hubspot_soporte",
  "object_type": "tickets",
  "object_id": "{{data.ticketId}}",
  "properties": { "hs_pipeline_stage": "4" }
}

Notas

Solo cambian las propiedades que enviás; las que omitís conservan su valor actual.
Para vaciar una propiedad, mandala como cadena vacía (""). Enviar null HubSpot lo rechaza en la mayoría de los tipos de propiedad.
Las propiedades de solo lectura, como createdate o hs_object_id, no se pueden escribir y devuelven un 400.
Un 404 significa que el id no existe para ese object_type. Ni el 400 ni el 404 se reintentan: corregí los datos y volvé a ejecutar.
Si properties está vacío o no parsea como JSON, el nodo se detiene antes de llamar a HubSpot.

Nodos relacionados

HubSpot: Leer objeto — mirá los valores actuales antes de decidir qué cambiar.
HubSpot: Crear objeto — creá el registro cuando todavía no existe.
HubSpot: Buscar objetos — resolvé el id a partir de un email u otra propiedad.