API de GoHighLevel: cómo conectarlo con cualquier software

Guía técnica de la API de GoHighLevel: autenticación con Private Integration Tokens u OAuth, webhooks, límites de peticiones y la arquitectura con middleware para conectarlo con tu ERP, Holded, Odoo o cualquier otro software.

API de GoHighLevel: conexión con cualquier software mediante API y webhooks

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ónCuándo encajaLimitaciones
1. Integración ya existente (apps del Marketplace, conectores nativos)El caso está resuelto por una app que ya hace lo que necesitasFuncionalidad 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 externoPoco 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 sistemasSe vuelven difíciles de mantener si crece la lógica; el coste sube con el volumen
4. API directa y middleware propioProcesos críticos, mucho volumen, reglas de negocio complejas o necesidad de control totalRequiere 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 paraIntegraciones internas o de una sola cuenta: tu propia empresa o un cliente concretoApps públicas o del Marketplace que se instalan en varias cuentas y necesitan autorización del usuario
Cómo se obtieneSe crea en Ajustes → Private Integrations, eligiendo los permisos (scopes)Registrando una app en el Marketplace y completando el flujo de autorización
CaducidadNo se renueva solo: hay que rotarlo o regenerarlo manualmenteTokens con renovación
Cuándo lo elijoCasi siempre en proyectos para una empresa concretaCuando 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 antigua X-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

  1. Define qué sistema manda en cada dato antes de escribir una línea de código.
  2. Usa un identificador único (NIF/CIF, ID interno) para reconocer al mismo cliente en ambos sistemas.
  3. Guarda los IDs cruzados en campos personalizados de GoHighLevel y en el otro sistema.
  4. Haz operaciones idempotentes (crear o actualizar, no solo crear).
  5. Verifica siempre la firma de los webhooks.
  6. Responde rápido y procesa después, con una cola.
  7. Respeta los límites y lee las cabeceras de uso.
  8. Fija la versión de la API en tus peticiones.
  9. Principio de mínimos permisos: solo los scopes necesarios y secretos fuera del código.
  10. 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

SoftwarePatrón habitualMás información
ERP en generalOportunidad ganada → cliente y documento en el ERP; estado de cobro de vuelta al CRMGuía de integración con ERP
HoldedVenta cerrada → contacto y factura en Holded; factura pagada → onboardingGoHighLevel + Holded
OdooCliente y pedido en Odoo; avisos de factura vencida al CRMGoHighLevel + Odoo
Software de gestión de un sector (clínicas, despachos, concesionarios…)Cita o expediente creado en el programa; seguimiento y comunicaciones en GoHighLevelSe diseña caso a caso según su API
Software sin APIExportaciones programadas, conectores o RPA como último recursoMá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.