Introducción
No siempre el formulario de tu web está hecho con HubSpot — puede estar en cualquier plataforma o desarrollado a medida. Aun así, puedes conectarlo para que cada envío cree automáticamente un contacto en tu CRM, usando la API de HubSpot. En este tutorial te mostramos cómo hacerlo paso a paso.
¿Por qué usar la API en vez de un formulario nativo de HubSpot?
Cuando ya tienes un formulario funcionando en tu sitio (con su propio diseño, validaciones, etc.) y no quieres reemplazarlo por el formulario embebido de HubSpot, puedes mantenerlo tal cual y simplemente enviar los datos a HubSpot por detrás, usando la API.
¿Qué necesitas antes de empezar?
- Una cuenta de HubSpot con acceso a Configuración > Desarrollo > Claves de servicio.
- Acceso al backend de tu sitio (el lenguaje o plataforma no importa: PHP, Node.js, Python, etc.).
- El token nunca debe ir en el HTML/JavaScript del formulario — solo en el código del servidor, para que no quede expuesto públicamente.
Paso 1: Crea una clave de servicio en HubSpot
Ve a Configuración > Desarrollo > Aplicaciones privadas > Claves de servicio, clic en Crear clave de servicio, dale un nombre.
Paso 2: Define el permiso (scope)
Activa el permiso crm.objects.contacts.write (necesario para crear contactos).
Paso 3: Copia el token
Al crear la clave, HubSpot te muestra el token una sola vez — cópialo y guárdalo en un lugar seguro.
Paso 4: Crea el proceso en tu servidor
En el backend de tu sitio, crea un endpoint (una URL específica) que reciba los datos del formulario y haga la petición a la API de HubSpot, incluyendo el token de forma segura.
Paso 5: Entiende cómo se conectan
El formulario HTML manda los datos a esa URL de tu servidor. El servidor recibe esos datos, arma la petición y la envía a HubSpot con el token — el navegador nunca ve ni maneja el token directamente.
Paso 6: Agrega el formulario en tu página
Inserta el formulario con los campos que necesites (nombre, apellido, correo, teléfono), apuntando su envío al endpoint de tu servidor.
Paso 7: Haz una prueba de envío
Completa el formulario en la página real, con datos de prueba, y envíalo.
Paso 8: Verifica el mensaje de confirmación
Confirma que, tras enviar, el usuario vea una confirmación clara de que el envío fue exitoso.
Paso 9: Verifica en HubSpot
Ve a CRM > Contactos, busca el correo de prueba y confirma que el contacto se haya creado con los datos enviados.
Paso 10: Revisa errores comunes
- Token inválido o mal copiado → error 401.
- Falta el permiso correcto → error 403.
- Formato de datos incorrecto en la petición → error 400.