HubSpot - Borrar objeto

↩ Parte de la integración HubSpot.

Descripción

Archiva un registro del CRM de HubSpot (DELETE /crm/v3/objects/{object_type}/{id}).

El borrado de HubSpot es en realidad un archivado: el registro sale de las listas, los informes y el índice de búsqueda, pero queda recuperable desde la interfaz de HubSpot durante un tiempo. El nodo lo refleja devolviendo archived: true.

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 archivar

Tanto object_type como object_id aceptan variables dinámicas.

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

HubSpot responde con el cuerpo vacío, así que el nodo arma un objeto de confirmación:

{
  "archived": true,
  "id": "701",
  "objectType": "contacts"
}

Junto con él, _meta:

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

Ejemplo de uso

Archivar un contacto

{
  "credentials_id": "hubspot_marketing",
  "object_type": "contacts",
  "object_id": "{{data.contactId}}"
}

Archivar un negocio perdido

{
  "credentials_id": "hubspot_ventas",
  "object_type": "deals",
  "object_id": "{{data.dealId}}"
}

Archivar un ticket resuelto

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

Notas

El borrado es un archivado, no un borrado definitivo. Para eliminar datos personales de forma permanente —una solicitud de supresión del RGPD, por ejemplo— usá el endpoint específico de GDPR de HubSpot a través del nodo HTTP.
Archivar una empresa o un negocio no borra los objetos asociados; solo desaparece la asociación de la vista.
Un 404 significa que el registro no existe o que ya estaba archivado. Ese error no se reintenta.
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.
El registro no se devuelve antes de archivarlo. Si necesitás una copia, leelo primero con Leer objeto.

Nodos relacionados

HubSpot: Leer objeto — guardá una copia del registro antes de archivarlo.
HubSpot: Buscar objetos — encontrá los registros que hay que archivar.
HubSpot: Actualizar objeto — marcá el registro en vez de archivarlo.