Requisitos: cuenta de HubSpot con permisos para crear aplicaciones privadas (apartado 2).
- Entra en tu cuenta de HubSpot y ve a Configuración → Integraciones → Aplicaciones privadas.
- Pulsa Crear una aplicación privada. Dale un nombre reconocible — por ejemplo el de tu propio negocio, nunca uno genérico como «prueba».
- Ve a la pestaña Scopes («Ámbitos») y marca estos cinco permisos — son los mínimos que necesita el conector, ni uno más:
| Scope | Para qué lo usa el conector |
|---|---|
crm.objects.contacts.read | Buscar y leer contactos existentes. |
crm.objects.contacts.write | Crear o actualizar un contacto (acción «lead → contacto», apartado 5). |
crm.objects.deals.read | Buscar negocios (deals) existentes. |
crm.objects.deals.write | Crear un negocio o cambiar su etapa (acción «etapa → negocio», apartado 5). |
crm.objects.owners.read | Leer los propietarios (usuarios de HubSpot) de un contacto o negocio. |
- Guarda la aplicación. HubSpot muestra el token de acceso, con el formato
pat-eu1-…— cópialo antes de cerrar la ventana: por seguridad, HubSpot solo lo enseña completo esta primera vez (después puedes volver a revelarlo desde la pestaña Auth de la propia aplicación si lo necesitas de nuevo).
Aviso — Verificado contra la documentación oficial — un nombre que puede variar
La ruta Configuración → Integraciones → Aplicaciones privadas de arriba es la que usa esta guía porque es la que describe el propio formulario de conexión de Platform. Al revisar la documentación oficial de HubSpot para este manual (
developers.hubspot.com/docs/api/private-appsydevelopers.hubspot.com/docs/guides/apps/private-apps/overview, consultadas el 5 de septiembre de 2026), HubSpot llama hoy a este mismo mecanismo «Legacy private apps» («aplicaciones privadas heredadas») y lo sitúa en el menú Development → Legacy apps → Create legacy app → Private de su portal para desarrolladores. HubSpot mantiene el mecanismo — un token de aplicación privada sigue funcionando igual — pero puede haber renombrado o movido el menú en tu cuenta según cuándo se creó. Si no encuentras «Aplicaciones privadas» donde indica el paso 1, busca «Legacy apps» («aplicaciones heredadas»); este aviso se retirará en cuanto la sesión de capturas confirme la ruta exacta que ve un administrador nuevo hoy.