Aplicaciones privadas de HubSpot: qué hacer con tus integraciones en Chile

Las aplicaciones privadas de HubSpot pasaron a llamarse aplicaciones privadas heredadas (legacy) y, a partir del 26 de octubre de 2026, las cuentas existentes ya no podrán crear nuevas. Las que tienes hoy siguen funcionando, así que tu integración con el ERP no se corta ese día. Lo urgente para una empresa B2B en Chile o Latinoamérica es otra cosa: saber qué apps y tokens existen, a nombre de quién están y qué APIs usan, porque HubSpot dejará sin soporte las APIs v1 a v3 y las apps heredadas en septiembre de 2027.

En resumen

• A partir del 26 de octubre de 2026 tu cuenta de HubSpot no podrá crear aplicaciones privadas heredadas, pero las que existen seguirán funcionando igual que antes.
• El riesgo real está en septiembre de 2027, cuando las APIs v1 a v3 y las apps heredadas quedan sin correcciones ni actualizaciones de seguridad.
• El primer paso es un inventario de apps, tokens, permisos y dueños; después decides entre Service Keys, una app por proyecto o migrar la app actual.

El síntoma suele aparecer tarde. Un día alguien necesita una conexión nueva entre HubSpot y el sistema de facturación y descubre que el botón para crear la app ya no está. O peor: la integración con el ERP la hizo un proveedor hace tres años, sigue funcionando, pero nadie sabe qué token usa ni quién puede rotarlo, porque el superadministrador que la creó ya no trabaja en la empresa. Si se va el proveedor, nadie sabe cómo funciona.

Esta guía es para gerentes generales y comerciales de empresas B2B en Chile, México, Colombia y Perú que dependen de una integración entre HubSpot y su ERP, un portal o un desarrollo propio, y para el equipo de TI que los acompaña. Explica qué cambió, qué no cambió y cómo ordenar tus integraciones antes de que el plazo de 2027 se vuelva una urgencia. El contexto de la noticia está en nuestra nota sobre el fin de la creación de private apps heredadas.

¿Qué cambia con las aplicaciones privadas de HubSpot y qué no?

Cambia la posibilidad de crear apps privadas heredadas nuevas; no cambia el funcionamiento de las que ya existen. HubSpot lo dice de forma explícita en su registro de cambios para desarrolladores: las apps heredadas existentes siguen operando sin cambios y el ajuste solo quita la opción de crear nuevas.

Hasta el 25 de octubre todavía puedes crear apps heredadas, pero quedarán sin soporte en septiembre de 2027, así que no conviene partir una integración nueva de esa forma. El cambio llega en dos fechas y se conecta con un segundo anuncio, el del fin de soporte de las APIs antiguas, que es el que define tu plazo real.

Fecha	Qué pasa	Qué significa para tu empresa
28 de septiembre de 2026	Las cuentas creadas desde esa fecha no pueden crear apps privadas heredadas	Si abres un portal nuevo, por ejemplo para otro país, parte directo con Service Keys o apps por proyecto
26 de octubre de 2026	Las cuentas existentes tampoco pueden crear apps privadas heredadas	Las integraciones actuales siguen; las nuevas se construyen con otra credencial
Marzo de 2027	Fin del plazo para la versión 4 de las APIs (30 de marzo) y para migrar proyectos de la versión 2025.2 a la 2026.09	Si tu proveedor usa v4 o proyectos 2025.2, su plazo es anterior
Septiembre de 2027	Las APIs v1, v2 y v3 y las apps heredadas quedan sin soporte	Sin correcciones de errores ni actualizaciones de seguridad para lo que no migres

Sin soporte significa que HubSpot deja de publicar correcciones, mejoras de confiabilidad y actualizaciones de seguridad para esas versiones, según su anuncio sobre APIs y apps heredadas. HubSpot recomienda pasar directo a las APIs con versión por fecha y no usar v3 ni v4 como paso intermedio. Cubrimos ese anuncio en la nota sobre el fin de soporte de las APIs v1 a v3.

¿Cómo inventariar las apps, tokens e integraciones de tu cuenta?

Haz el inventario antes de decidir cualquier migración: en la mayoría de las empresas en Chile nadie tiene la lista completa de qué sistemas escriben en HubSpot y con qué credencial. Solo un superadministrador puede ver las apps privadas heredadas, en Development > Legacy apps (los nombres en la interfaz en inglés).

Para cada integración, anota lo siguiente en una planilla compartida entre TI y el área comercial:

1. Nombre de la app y sistema que conecta: ERP, facturación, portal de cotizaciones, web, desarrollo propio.
2. Quién la creó y quién la mantiene hoy: persona interna, proveedor actual o un proveedor que ya no está.
3. Dónde vive el código y dónde está guardado el token: servidor propio, servidor del proveedor o una plataforma de automatización.
4. Permisos (scopes) que tiene: si una app de facturación puede leer y escribir contactos, negocios y tickets, probablemente tiene más acceso del que necesita.
5. Qué versión de API usa: pídele al desarrollador que revise si las llamadas van a rutas v1, v2 o v3.
6. Si usa webhooks o extensiones de interfaz: esto define qué alternativa le sirve.
7. Qué datos mueve y con qué frecuencia: empresas, negocios, productos, estados de factura.

Para confirmar qué integración está creando registros, revisa la propiedad Fuente de registro en contactos, empresas y negocios: indica cómo se creó cada registro, por ejemplo con una importación, un formulario o una integración. Si quieres hacerlo para todo el portal, la guía de HubSpot Audit de Revenue Hub Latam explica cómo ver quién crea los registros de tu HubSpot.

Si una app no tiene dueño claro, trátala como un riesgo de seguridad antes que como un tema de migración: un token activo sin responsable es una llave de tu CRM que nadie vigila.

¿Service Keys, app por proyecto o seguir con la app heredada?

Usa Service Keys para integraciones que solo leen y escriben datos por API, y una app por proyecto cuando la integración necesita webhooks o extensiones dentro de HubSpot. La app heredada puede seguir operando mientras planificas, pero no es destino final.

Las Service Keys son credenciales a nivel de cuenta para conexiones de sistema a sistema. HubSpot las abrió en beta pública en febrero de 2026 y, en su resumen de novedades para desarrolladores de septiembre de 2026, todavía las presenta en beta pública. Aun así, las recomienda como reemplazo para integraciones privadas nuevas. Se crean en Development > Keys > Service keys y las administran los superadministradores y los usuarios con el permiso de herramientas de desarrollo.

Criterio	Service Keys	App privada por proyecto	App privada heredada
Cuándo sirve	Integración solo de datos por API REST (ERP, facturación, planillas)	Integración que necesita webhooks, extensiones de interfaz o funciones de la plataforma	Lo que ya existe, mientras migras
Cómo se crea	Desde el menú Development de la cuenta, sin línea de comandos	Con la CLI de HubSpot, como proyecto de desarrollo	No se podrán crear a partir del 26 de octubre de 2026
Webhooks	No	Sí	Sí
Permisos	Por objeto, limitados a los que tiene quien la crea	Definidos en la configuración del proyecto	Los que se asignaron al crearla
Si se va quien la creó	La llave sigue activa y los administradores mantienen el control	Depende de quién administre el proyecto y el código	El token sigue funcionando; para administrarla necesitas otro superadministrador
Estado	Beta pública (según HubSpot, a septiembre de 2026)	Plataforma vigente (versión 2026.09)	Sin soporte desde septiembre de 2027

Un caso que conviene revisar con cuidado: si tu proveedor construyó la integración como proyecto de desarrollo (no como app heredada) sobre la versión 2025.2, ese proyecto también tiene plazo para pasar a la versión 2026.09 en marzo de 2027. Pídele que lo confirme por escrito.

¿Cómo rotar un token sin cortar la integración con tu ERP?

Rota con expiración diferida, nunca inmediata, salvo que el token esté comprometido. Tanto las apps privadas heredadas como las Service Keys permiten rotar la credencial y dejar la anterior activa 7 días, lo que da margen para actualizar el sistema conectado sin que se caiga la sincronización.

1. Avisa antes al responsable del ERP o del servidor donde vive la integración y acuerda una ventana de trabajo.
2. Elige "Rotate and expire later": HubSpot crea un token nuevo y el anterior expira a los 7 días. Usa "Rotate and expire now" solo si sospechas que el token se filtró.
3. Actualiza el token en el servidor, la plataforma de automatización o la configuración del conector, y guárdalo en un gestor de secretos de tu empresa, no en un correo ni en una planilla.
4. Prueba con un caso real: crea o modifica una empresa o un negocio de prueba y confirma que viaja en ambos sentidos.
5. Expira el token anterior cuando confirmes que todo funciona, sin esperar los 7 días si no hace falta.
6. Revisa que siga llegando información los días siguientes. Una integración puede fallar en silencio; la guía sobre cómo saber si una integración de HubSpot dejó de funcionar explica qué alertas configurar.

Si tu integración con el ERP también emite o consulta facturas electrónicas del SII, prueba ese flujo completo. En Chile la factura la emite el ERP, no HubSpot, y un cambio de credencial mal probado puede dejar negocios ganados sin factura asociada. La guía para integrar HubSpot con tu ERP y la facturación electrónica en Chile detalla qué dato manda cada sistema.

¿Qué pedirle a tu proveedor de integraciones antes de 2027?

Pídele un plan escrito por integración, con fecha, y que las credenciales nuevas queden a nombre de tu empresa. Las apps heredadas se crearon muchas veces con el usuario de un consultor o en el portal sin documentación, y la migración es la oportunidad de corregirlo.

• Lista de integraciones con versión de API, tipo de credencial, permisos y dueño de cada una.
• Destino de cada una: Service Keys, app por proyecto o espera justificada, con la fecha de migración.
• Código en un repositorio de tu empresa y manual de operación, no solo en el servidor del proveedor.
• Credenciales creadas con usuarios de tu empresa y guardadas en tus sistemas, con al menos dos administradores.
• Permisos mínimos: cada credencial solo con los objetos que necesita.
• Pruebas con casos reales antes de apagar la app anterior y una alerta si la integración deja de traer datos.

Si tu proveedor no puede entregarte esa información o ya no trabaja contigo, el problema no es técnico sino de traspaso. La guía para cambiar de partner de HubSpot sin perder integraciones explica cómo pedir código y llaves de forma ordenada.

¿Cómo te ayuda Revenue Hub Latam?

Con Integraciones con dueño inventariamos las integraciones que ya existen en tu HubSpot, pedimos código y llaves, y las migramos con precio cerrado. Aplica la garantía Es tuyo: código, llaves y manual a nombre de tu empresa. Y con Avisa dejamos una alerta que te avisa si una integración deja de traer datos. Si quieres partir por una conversación, agenda un Diagnóstico de 30 minutos sin costo.

Preguntas frecuentes

¿Puedo seguir creando apps privadas heredadas antes del 26 de octubre?

Sí, hasta el 25 de octubre de 2026 una cuenta existente todavía puede crearlas, siempre que lo haga un superadministrador. No lo recomendamos para integraciones nuevas: quedarán sin soporte en septiembre de 2027 y tendrás que migrarlas igual. Si la integración solo mueve datos por API, una Service Key evita hacer el trabajo dos veces.

¿Qué son las Service Keys de HubSpot?

Son credenciales a nivel de cuenta para que otro sistema lea o escriba datos de HubSpot por API, sin construir una app completa. Se crean desde el menú Development, con permisos por objeto, y se pueden rotar con un período de 7 días. No sirven para webhooks ni extensiones de interfaz. HubSpot las abrió en beta pública en febrero de 2026 y a septiembre de 2026 seguían en esa etapa.

¿Qué pasa si mi integración necesita webhooks?

Las Service Keys no admiten webhooks. Si tu integración recibe avisos de HubSpot cuando cambia un negocio o un contacto, necesitas una app privada basada en proyectos, creada con la CLI de HubSpot, o seguir con la app heredada mientras planificas. En empresas de Chile esto es común en integraciones que disparan la creación de un cliente en el ERP al ganar un negocio.

¿Quién puede ver las aplicaciones privadas heredadas en mi cuenta?

Solo los superadministradores de la cuenta de HubSpot pueden acceder a las apps privadas heredadas. Si en tu empresa hay un solo superadministrador, o si ese rol lo tiene una persona del proveedor, corrige eso antes de empezar el inventario. Para Service Keys, además de los superadministradores pueden administrarlas los usuarios con el permiso de herramientas de desarrollo.

¿Qué significa que una API quede sin soporte?

Significa que HubSpot deja de publicar correcciones de errores, mejoras de confiabilidad y actualizaciones de seguridad para esa versión. Una integración sobre una API sin soporte puede seguir respondiendo un tiempo, pero cualquier falla queda sin arreglo de parte de HubSpot. Para una empresa B2B en Latinoamérica, eso es depender de algo que nadie mantiene.

¿Conviene migrar todo ahora o esperar?

Conviene hacer el inventario ahora y migrar por prioridad. Las integraciones críticas, como el ERP o la facturación, merecen un plan con fecha durante el primer semestre de 2027. Las integraciones menores, como una planilla o un formulario externo, pueden ir después. Lo que no conviene es descubrir en agosto de 2027 cuántas apps tienes.

¿La migración cambia los datos que ya están en HubSpot?

No por sí misma. Cambiar la credencial o la versión de la API no modifica los registros existentes, pero una migración mal probada puede duplicar empresas o dejar de actualizar campos. Por eso conviene probar con casos reales de tu operación, en un ambiente de prueba cuando el sistema lo permite, y revisar los días siguientes que la información siga llegando.