Cambio disruptivo: HubSpot aplicará las validaciones de escritura del CRM en la versión 2026-09 de la API

HubSpot anunció el 11 de agosto de 2026 un cambio disruptivo en su API del CRM. A partir de la versión /2026-09/, que se libera el 8 de septiembre de 2026, las reglas de validación que configura el administrador del portal dejarán de ser exclusivas de la interfaz y pasarán a aplicarse también en todas las rutas de escritura de la API. Cualquier integración que cree o actualice registros del CRM debe revisarse antes de subir de versión.

¿Qué cambia exactamente en la API de HubSpot?

Son tres comportamientos que hasta ahora solo existían en la interfaz y que ahora se van a exigir por API:

• Propiedades requeridas condicionales. Si un administrador configuró una regla que vuelve obligatoria una propiedad cuando otra toma cierto valor (por ejemplo, que close_date pase a ser requerida cuando dealstage queda en closedwon), la API devolverá un error de validación 400 si esa propiedad falta. Antes estas reglas eran solo de interfaz y la API las ignoraba.
• Configuración del creador de registros. Si el administrador marcó propiedades o asociaciones como obligatorias al crear un registro en Configuración, Objetos, tipo de objeto, Crear registro, la API hará cumplir esos requisitos en las llamadas POST.
• Permiso Editar asociaciones. Si tu app usa OAuth a nivel de usuario y el usuario que la instala no tiene el permiso «Editar asociaciones», las llamadas que creen, actualicen o eliminen asociaciones devolverán error. Esto no afecta a los tokens de app a nivel de portal.

HubSpot es explícito en un punto que evita el pánico innecesario: estos comportamientos solo se activan cuando un administrador configuró efectivamente esas reglas en el portal. Si no existen reglas condicionales, requisitos en Crear registro ni restricciones de permisos de asociación, no hay cambio de comportamiento.

¿A quién le pega este cambio?

A cualquier integración que escriba en el CRM: sincronizaciones con ERP, formularios propios, enriquecimiento de datos, migradores, apps del marketplace, automatizaciones internas y agentes que crean o actualizan registros. En Chile y Latinoamérica esto toca especialmente a los equipos que construyeron conectores a medida entre HubSpot y sistemas locales de facturación, cobranza o logística, donde la lógica de campos obligatorios suele estar en el portal y no replicada en el código de la integración.

La razón que da HubSpot es de gobierno de datos: la API estaba dejando pasar escrituras que violaban las expectativas del propio usuario del portal y dejaban los registros en estados inconsistentes con sus propias reglas. El costo de esa permisividad se pagaba después, en reportes que no cuadraban.

¿Cómo preparar tus integraciones antes del 8 de septiembre?

HubSpot publicó cinco pasos concretos:

1. Revisar la cuenta donde escribe la app: Configuración, Propiedades para las reglas condicionales; Configuración, Objetos, objeto, Crear registro para los campos obligatorios; y Configuración, Usuarios y equipos para confirmar los permisos del usuario instalador.
2. Traer las definiciones actuales de propiedades vía GET /crm/{version}/properties/{objectType} para identificar campos requeridos antes de escribir.
3. Asegurar que las llamadas de escritura incluyan todas las propiedades condicionalmente requeridas cuando la propiedad que las controla tiene valor.
4. Asegurar que los POST de creación incluyan todas las propiedades y asociaciones marcadas como obligatorias.
5. Si la app usa OAuth de usuario, confirmar que el usuario instalador tenga «Editar asociaciones» habilitado, o sacar las escrituras de asociación del alcance de la app.

Sobre el manejo de errores, HubSpot recomienda parsear el mensaje (cada violación identifica la regla específica), volver a revisar la configuración del portal porque un administrador pudo cambiarla después de configurar la integración, reintentar solo con el input corregido y nunca con la misma solicitud sin cambios, y traducir el mensaje técnico a una guía accionable para el usuario final.

¿Qué más trae la versión 2026-09?

Junto al endurecimiento de validaciones viene una mejora en sentido contrario: la API pasa a ser más permisiva con las propiedades de fecha y hora. Entradas válidas que antes se rechazaban con errores como INVALID_DATE, entre ellas valores de fecha fuera de medianoche, cadenas ISO-8601 o timestamps en segundos epoch, ahora se normalizan y devuelven una respuesta exitosa con un nuevo arreglo warnings que describe la normalización aplicada. Los mensajes de error genuinos también mejoran: ahora incluyen el input crudo, la interpretación que hizo el sistema y qué restricción se violó.

Si tu integración espera una forma específica del mensaje de error, ese contrato cambia y hay que actualizarlo.

Análisis de Revenue Hub

Este cambio parece técnico y de bajo perfil, pero es una señal de gobierno de datos que conviene leer como líder comercial y no solo como problema de TI. Durante años la API de HubSpot fue una puerta trasera que ignoraba las reglas que el propio equipo de RevOps definía en el portal. Todo el esfuerzo de configurar campos obligatorios y lógica condicional se evaporaba cuando una integración escribía directo. HubSpot está cerrando esa puerta.

La consecuencia práctica en Chile y Latinoamérica es que muchos portales van a descubrir en septiembre que sus integraciones venían escribiendo registros incompletos de forma sistemática. El error 400 no crea el problema, lo hace visible. El riesgo real no es la falla del endpoint, es lo que la falla revela: procesos comerciales cuyo dato de cierre, monto o asociación nunca estuvo completo, y reportes de pipeline que se construyeron sobre eso.

La decisión para las próximas tres semanas es concreta y no admite delegación total: alguien tiene que hacer el inventario de qué integraciones escriben en el CRM, cuáles usan OAuth de usuario y qué reglas condicionales existen en el portal. Es un trabajo de horas, no de semanas, y hacerlo antes del 8 de septiembre es la diferencia entre una migración controlada y una semana apagando incendios. Puedes seguir el resto de los cambios del ecosistema en nuestras noticias de HubSpot.