Agustín Manson · Implementador GHL · B2B Sales Strategist
«¿GoHighLevel se puede conectar con X?» Es la pregunta que más me hacen en las primeras reuniones, y la respuesta casi siempre empieza igual: si X tiene API, webhooks o al menos una forma de importar y exportar datos, sí. Lo que cambia es el camino, el coste y lo frágil que será la conexión.
Esta guía explica cómo funciona la API de GoHighLevel desde el punto de vista práctico: qué opciones tienes para conectarlo con otro software, cómo se autentica, cómo recibir avisos con webhooks, qué límites tiene y qué arquitectura recomiendo cuando la integración importa de verdad. Es la base técnica de las integraciones que hemos explicado para ERP en general, Holded y Odoo.
Una aclaración antes de empezar: los detalles técnicos de la API cambian con el tiempo. Los datos de este artículo están contrastados con la documentación oficial de HighLevel a mediados de octubre de 2026, y al final te indico dónde revisarlos.
Cuatro formas de conectar GoHighLevel con otro software
No todo se resuelve con la API. Antes de programar nada, conviene elegir el nivel adecuado:
| Opción | Cuándo encaja | Limitaciones |
|---|---|---|
| 1. Integración ya existente (apps del Marketplace, conectores nativos) | El caso está resuelto por una app que ya hace lo que necesitas | Funcionalidad fija; poco margen para reglas propias |
| 2. Workflows con webhooks (el workflow envía o recibe datos) | Flujos sencillos: avisar a otro sistema cuando ocurre algo, o recibir un dato externo | Poco control de errores y reintentos; algunas acciones y triggers premium pueden tener coste adicional |
| 3. Herramientas intermedias (Make, n8n, Zapier) | Flujos de complejidad baja o media con varios sistemas | Se vuelven difíciles de mantener si crece la lógica; el coste sube con el volumen |
| 4. API directa y middleware propio | Procesos críticos, mucho volumen, reglas de negocio complejas o necesidad de control total | Requiere desarrollo y mantenimiento |
Mi criterio: empieza por el nivel más bajo que resuelva el problema y sube solo cuando lo necesites. Una integración sencilla con un workflow y un webhook, bien vigilada, vale más que un middleware enorme que nadie mantiene.
Qué API hay que usar: la v2
HighLevel indica en su documentación que la API v1 llegó al fin de soporte el 31 de diciembre de 2025: las integraciones antiguas pueden seguir funcionando, pero no reciben actualizaciones ni soporte. Todo lo nuevo debe construirse sobre la API v2, cuya documentación oficial está en el Marketplace de desarrolladores de HighLevel. Si heredas una integración que todavía usa la v1, plantéate migrarla antes de que se convierta en un problema.
Autenticación: Private Integration Token u OAuth
La API v2 ofrece dos formas de autenticarse, y la elección depende de quién va a usar la integración:
| Private Integration Token (PIT) | OAuth 2.0 | |
|---|---|---|
| Pensado para | Integraciones internas o de una sola cuenta: tu propia empresa o un cliente concreto | Apps públicas o del Marketplace que se instalan en varias cuentas y necesitan autorización del usuario |
| Cómo se obtiene | Se crea en Ajustes → Private Integrations, eligiendo los permisos (scopes) | Registrando una app en el Marketplace y completando el flujo de autorización |
| Caducidad | No se renueva solo: hay que rotarlo o regenerarlo manualmente | Tokens con renovación |
| Cuándo lo elijo | Casi siempre en proyectos para una empresa concreta | Cuando construyes un producto para muchos clientes |
Para integrar el GoHighLevel de una empresa con su ERP, un PIT con los permisos mínimos suele ser lo adecuado. Dos reglas que aplico siempre: solo los scopes necesarios y el token en un gestor de secretos o variables de entorno, nunca dentro de un workflow compartido ni en el código.
Un ejemplo de petición
Así se ve una llamada básica a la API v2 con un PIT, según el ejemplo de la documentación oficial (la URL base es https://services.leadconnectorhq.com):
GET https://services.leadconnectorhq.com/locations/{LOCATION_ID}
Authorization: Bearer <TU_PRIVATE_INTEGRATION_TOKEN>
Accept: application/json
Version: 2021-07-28
Fíjate en la cabecera Version: la API la exige y conviene fijarla explícitamente en tu código. Los endpoints, los parámetros y los campos exactos de cada recurso (contactos, oportunidades, calendarios, conversaciones…) están en la referencia oficial. Un ejemplo ilustrativo de cómo se plantearía crear o actualizar un contacto sin duplicarlo:
POST https://services.leadconnectorhq.com/contacts/upsert
Authorization: Bearer <TU_PRIVATE_INTEGRATION_TOKEN>
Content-Type: application/json
Version: 2021-07-28
{
"locationId": "{LOCATION_ID}",
"email": "cliente@empresa.com",
"companyName": "Empresa ABC S.L.",
"customFields": [
{ "id": "{ID_CAMPO_ERP}", "value": "ERP-10458" }
]
}
Es solo una ilustración del patrón (buscar o crear, y guardar el ID del otro sistema en un campo personalizado). Antes de usarlo, comprueba los nombres de campo vigentes en la referencia de la API.
Webhooks: que GoHighLevel te avise a ti
Preguntar a la API cada pocos minutos si algo ha cambiado funciona, pero es ineficiente. Con webhooks, HighLevel envía una petición HTTP a tu servidor cuando ocurre un evento: se crea un contacto, cambia una oportunidad, se reserva una cita, se emite una factura… Cada aviso incluye el tipo de evento, la fecha, un identificador de webhook y los datos del evento.
Según la documentación oficial, así se plantea un receptor de webhooks fiable:
- Verifica la firma. Cada petición lleva una firma que debes comprobar contra el cuerpo sin modificar. El método actual es la cabecera
X-GHL-Signature(Ed25519); la cabecera antiguaX-WH-Signature(RSA-SHA256) figura como obsoleta a partir del 1 de septiembre de 2026. Si la verificación falla, rechaza la petición. - Responde rápido con un 2xx. Haz el trabajo pesado en segundo plano (una cola), no mientras HighLevel espera.
- Prepárate para duplicados. Si no recibe un 2xx, HighLevel reintenta con espera creciente, hasta 12 veces tras el primer intento. Por eso hay que deduplicar por el identificador de webhook y hacer el procesamiento idempotente (procesar dos veces el mismo aviso no debe crear dos facturas).
- Vigila la salud del endpoint. HighLevel avisa si la tasa de éxito de un endpoint con mucho tráfico cae por debajo del 90% y puede pausar la entrega.
Los webhooks de esta forma se configuran en una app de HighLevel (en el Marketplace de desarrolladores). Para casos sencillos dentro de tu propia cuenta, los workflows también pueden enviar datos a una URL externa o arrancar con un aviso entrante, con la diferencia de que ofrecen menos control sobre firmas y reintentos.
Límites de la API que debes tener en cuenta
La documentación de límites indica, para los endpoints de la API 2.0 con OAuth, 100 peticiones cada 10 segundos y 200.000 al día, contabilizadas por separado para cada app y cada recurso (una subcuenta o una agencia). Las respuestas incluyen cabeceras como X-RateLimit-Remaining y X-RateLimit-Daily-Remaining para saber cuánto margen queda.
Para un PIT, comprueba en la documentación los límites que le aplican en tu caso. En cualquier integración, mi recomendación es la misma: lee esas cabeceras, implementa reintentos con espera creciente y no lances cargas masivas de golpe. La importación inicial de miles de registros se hace por lotes y con calma, no en una ráfaga.
La arquitectura que recomiendo: GoHighLevel + middleware + software externo
Cuando la integración es importante (facturación, pedidos, datos de clientes), no conecto los dos sistemas directamente. Pongo una capa en medio:
GoHighLevel
│ webhook (evento firmado)
▼
Receptor ──► verifica firma ──► responde 2xx ──► Cola de trabajos
│
▼
Middleware de integración
(deduplica, valida, transforma, reintenta)
│
▼
API del software externo
(ERP, Holded, Odoo, facturación...)
│
▼
Resultado ──► API de GoHighLevel (campos, etiquetas, etapas)
Esa capa intermedia (puede ser Make o n8n en proyectos pequeños, o un servicio propio en los grandes) aporta cuatro cosas que las conexiones directas no dan:
- Control de errores: registro de lo que ha pasado y alertas cuando algo falla.
- Reintentos y colas: si el otro sistema está caído, el dato espera en lugar de perderse.
- Transformación y validación: el NIF, las fechas y los importes llegan en el formato que espera el otro lado.
- Desacoplamiento: si cambias de ERP, cambias el middleware, no todos los workflows de GoHighLevel.
Diez prácticas que evitan la mayoría de problemas
- Define qué sistema manda en cada dato antes de escribir una línea de código.
- Usa un identificador único (NIF/CIF, ID interno) para reconocer al mismo cliente en ambos sistemas.
- Guarda los IDs cruzados en campos personalizados de GoHighLevel y en el otro sistema.
- Haz operaciones idempotentes (crear o actualizar, no solo crear).
- Verifica siempre la firma de los webhooks.
- Responde rápido y procesa después, con una cola.
- Respeta los límites y lee las cabeceras de uso.
- Fija la versión de la API en tus peticiones.
- Principio de mínimos permisos: solo los scopes necesarios y secretos fuera del código.
- Monitoriza y documenta: alertas de errores y un documento que explique qué hace cada flujo.
Ejemplos de conexión: qué cambia según el software
| Software | Patrón habitual | Más información |
|---|---|---|
| ERP en general | Oportunidad ganada → cliente y documento en el ERP; estado de cobro de vuelta al CRM | Guía de integración con ERP |
| Holded | Venta cerrada → contacto y factura en Holded; factura pagada → onboarding | GoHighLevel + Holded |
| Odoo | Cliente y pedido en Odoo; avisos de factura vencida al CRM | GoHighLevel + Odoo |
| Software de gestión de un sector (clínicas, despachos, concesionarios…) | Cita o expediente creado en el programa; seguimiento y comunicaciones en GoHighLevel | Se diseña caso a caso según su API |
| Software sin API | Exportaciones programadas, conectores o RPA como último recurso | Más caro y más frágil: hay que valorarlo antes de comprometer plazos |
Cuándo no necesitas la API
Conviene decirlo: muchas veces la API es excesiva. Si el flujo es «cuando pasa A, avisa a B» y el volumen es bajo, un workflow con un webhook o una herramienta intermedia basta y se mantiene solo. Si lo que necesitas es mover datos una vez (por ejemplo, importar clientes al empezar), una importación bien preparada es más barata y más segura que una integración permanente. La API compensa cuando hay flujos continuos, reglas de negocio o requisitos de fiabilidad que las opciones sencillas no cubren.
Preguntas que hago antes de presupuestar una integración
- ¿Qué software hay que conectar, en qué versión y tiene API o webhooks documentados?
- ¿Cuál es el flujo mínimo que ahorraría más tiempo desde la primera semana?
- ¿Qué sistema es la fuente de verdad de cada dato?
- ¿Qué volumen de registros y de eventos al día hay?
- ¿Qué debe pasar si una sincronización falla y quién se entera?
- ¿Quién mantendrá la integración cuando cambien las herramientas?
Dónde comprobar los datos actualizados
La referencia completa de endpoints, scopes y eventos está en la documentación oficial para desarrolladores de HighLevel. Los límites de peticiones están en su página de rate limits, y la guía de webhooks en la guía de integración de webhooks.
¿Aún no tienes GoHighLevel? Pruébalo antes de integrarlo
Si todavía no usas la plataforma, puedes crear una prueba gratuita y explorar su API y sus workflows. Si ya sabes qué quieres conectar y que quede bien montado desde el principio, reserva una consultoría con nosotros.
Crea tu prueba gratisReservar consultoría
Transparencia: Adqueria puede recibir una comisión de HighLevel si te registras a través de este enlace, sin coste adicional para ti.
Conectamos GoHighLevel con el software de tu empresa
En Adqueria, como partner de GoHighLevel en España, diseñamos e implementamos integraciones por API con los sistemas que ya usa tu empresa: ERP, facturación, software de gestión y herramientas propias. Empezamos mapeando el proceso y decidiendo qué nivel de integración necesitas de verdad, y construimos por fases, con control de errores y mantenimiento.
¿Necesitas conectar GoHighLevel con otro software? Solicita tu integración por API y revisamos contigo qué es viable en tu caso y por dónde empezar.