- Inicio
- Recursos
- Integraciones
- HighLevel
Integración HighLevel n8nAutomatiza HighLevel con n8n.
Tu CRM deja de depender del copiar y pegar. La integración HighLevel n8n abre 17 operaciones repartidas en 4 recursos: contactos, oportunidades, tareas y calendarios, con credencial OAuth2 sobre la API v2. No hay nodo trigger, así que el arranque llega de otro nodo del flujo.
Reseñas verificadas en Trustpilot · Agencia de IA, automatización y growth
¿Qué resuelve de verdad la integración HighLevel n8n?
El nodo HighLevel viene instalado con n8n y habla con la API v2 de HighLevel. Expone 17 operaciones repartidas en 4 recursos: contactos, oportunidades, tareas y calendarios. Cada una es un paso que colocas en el flujo, rellenas y encadenas con lo que venga después.
HighLevel no tiene nodo trigger en n8n. El flujo arranca en otro sitio: un Schedule Trigger a intervalo fijo, un Webhook de n8n, es decir una URL que n8n expone para que otro servicio le envíe datos, o el trigger de otra herramienta.
Primer terreno, el seguimiento que no se pierde. Termina una llamada, task.create cuelga la tarea del contacto con su Due Date, y el aviso sale hacia Slack en la misma ejecución, así que el comercial lo ve sin abrir el CRM.
Segundo terreno, el pipeline que refleja la realidad. opportunity.getAll saca los negocios filtrados por Status y por rango de fechas, y esa lista alimenta el informe que se vuelca en Google Sheets antes de la reunión de la semana.
Tercer terreno, la ficha que nace completa. Un formulario entra por Webhook, contact.create crea o actualiza el contacto sin duplicarlo, y SendGrid se ocupa del correo de bienvenida con los datos que acaban de llegar.
Tres reglas marcan el terreno de juego. En las operaciones de lista, Return All trae todos los resultados encadenando las páginas de la API; desactivado, Limit fija el número máximo de items devueltos. Un campo marcado como requerido bloquea la ejecución del nodo si está vacío, de modo que un Contact ID que falta detiene el flujo en lugar de adivinar. Y el propio nodo señala dos cosas sobre las oportunidades: solo puede haber una oportunidad por contacto, y el identificador de pipeline de una oportunidad no se puede actualizar.
Todo lo que queda fuera de estas 17 operaciones pasa por el nodo HTTP Request, que llama a cualquier endpoint de la API de HighLevel reutilizando la misma credencial mediante la autenticación predefinida. Es la prolongación normal, sin salir de n8n.
Si la duda sigue estando en la plataforma, la Reseña n8n repasa el alojamiento y el modelo de precios, y el Curso n8n monta un flujo completo de principio a fin.
¿Cómo se conecta HighLevel con n8n?
- 01
Crear la app en HighLevel
Todo empieza con una cuenta de desarrollador de HighLevel en el marketplace. Desde ahí, abre My Apps y pulsa Create App. La guía de configuración pide poner Distribution Type en Sub-Account. Esa app es la que guarda el Client ID y el Client Secret que después pegarás en n8n, así que ponle un nombre que describa para qué sirve y no quién la creó.
- 02
Declarar los scopes y la URL de redirección
La app lleva seis scopes:
locations.readonly,contacts.readonly,contacts.write,opportunities.readonly,opportunities.writeyusers.readonly. Después copia la OAuth Redirect URL que n8n muestra en la pantalla de la credencial y añádela como Redirect URL dentro de la app de HighLevel. Sin esa ida y vuelta, la autorización nunca regresa. - 03
Rellenar la credencial en n8n
El Client ID y el Client Secret se copian de HighLevel a la credencial de n8n, y los mismos seis scopes se listan ahí separados por espacios. Una credencial se crea una vez en el menú Credentials y se reutiliza en todos los flujos: el nodo HighLevel la ofrece en su desplegable a partir de ese momento, sin volver a teclear nada.
¿Qué sabe hacer el nodo HighLevel en n8n?
El nodo HighLevel expone 17 operaciones en 4 recursos. Para cada una: el nodo tal como lo configuras en n8n, los campos obligatorios y nuestras notas de campo.
| Recurso | Create or Update | Get | Get Many | Update | Delete | Book Appointment | Get Free Slots |
|---|---|---|---|---|---|---|---|
| Contact | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Opportunity | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Task | ✓ | ✓ | ✓ | ✓ | ✓ | ||
| Calendar | ✓ | ✓ |
Índice de operaciones
Contact
5 operacionesCreate or update a contact
contact.createLo que ves en n8n
Notas y casos de uso
Una sola llamada cubre los dos casos: si la persona ya está en HighLevel, su ficha se actualiza en lugar de duplicarse.
Parámetros clave
- Email: la dirección que identifica a la persona (
name@email.com). Hace falta Email o Phone para crear el contacto. - Phone: el mismo papel, en formato telefónico. Empieza por un prefijo de país válido precedido del signo más, como
+491234567890. - Additional Fields: 14 campos opcionales, entre ellos First Name, Last Name, Source, Tags como lista separada por comas, y Custom Fields.
Delete a contact
contact.deleteLo que ves en n8n
Notas y casos de uso
Retira la ficha de HighLevel. El nodo pide el identificador, no el nombre ni la dirección de correo.
Parámetros clave
- Contact ID: el identificador HighLevel de la ficha que se elimina. Suele llegar de un nodo anterior, recogido con una expresión como
{{ $json.field }}, que lee un campo del item entrante.
Get a contact
contact.getLo que ves en n8n
Notas y casos de uso
Lee un contacto y entrega sus datos al nodo siguiente, lo que ahorra la búsqueda a mano en la interfaz de HighLevel.
Parámetros clave
- Contact ID: la ficha que se lee. Encadénalo después de una operación de lista cuando lo único que tienes es un nombre o una dirección de correo.
Get many contacts
contact.getAllLo que ves en n8n
Notas y casos de uso
Devuelve una lista de contactos, con filtros que la reducen antes de que los datos lleguen al resto del flujo.
Parámetros clave
- Return All: activado, n8n encadena las páginas de la API hasta traer todos los contactos que coinciden. Desactivado, Limit fija el número máximo de contactos devueltos.
- Query: búsqueda libre, aplicada sobre Name, Phone, Email, Tags y Company Name.
- Sort By y Order: ordena por
date_addedodate_updated, ascendente (asc) o descendente (desc).
date_added con Return All activado, que alimenta el panel del equipo comercial.Update a contact
contact.updateLo que ves en n8n
Notas y casos de uso
Cambia solo los campos que indicas en una ficha existente y deja el resto como estaba.
Parámetros clave
- Contact ID: qué ficha se reescribe.
- Update Fields: 14 campos donde elegir, entre ellos Email, Phone, Tags, Timezone y Do Not Disturb, donde true significa que no se permite ningún mensaje saliente.
Opportunity
5 operacionesCreate an opportunity
opportunity.createLo que ves en n8n
Notas y casos de uso
Abre un negocio ligado a un contacto, con su nombre, su estado y su sitio en un pipeline.
Parámetros clave
- Contact Email or ID: se elige de la lista o se pasa un ID con una expresión. El nodo avisa de que solo puede haber una oportunidad por contacto.
- Status: uno entre
open,won,lostyabandoned. - Pipeline Name or ID: elegido de la lista o indicado como ID.
- Monetary Value: el valor monetario de la oportunidad, dentro de Additional Fields junto a Tags y Assigned To.
open con Monetary Value tomado del importe estimado.Delete an opportunity
opportunity.deleteLo que ves en n8n
Notas y casos de uso
Borra un negocio. Es la operación a la que recurres cuando unos registros tienen que desaparecer antes de que alguien lea las cifras del pipeline.
Parámetros clave
- Opportunity ID: el negocio que se retira, casi siempre arrastrado del nodo que lo creó o lo listó.
Get an opportunity
opportunity.getLo que ves en n8n
Notas y casos de uso
Trae un solo negocio con sus datos, para que un nodo posterior decida sobre algo real en lugar de suponer. Es la lectura puntual, la que resuelve una pregunta concreta dentro del flujo.
Parámetros clave
- Opportunity ID: el negocio que se lee, normalmente heredado del nodo anterior.
Get many opportunities
opportunity.getAllLo que ves en n8n
Notas y casos de uso
Lista negocios con 8 filtros, que es justo lo que quieres cuando hay que montar un informe sin tocar la interfaz.
Parámetros clave
- Return All: activado, todos los negocios que coinciden vuelven página tras página; desactivado, Limit pone el tope.
- Pipeline Name or ID y Stage Name or ID: primero un pipeline, después una etapa. El nodo pide el pipeline antes, si no las etapas no aparecen.
- Start Date y End Date: un rango de fechas sobre los negocios.
- Status:
open,won,lostoabandoned.
open dentro de un pipeline, repartido por Assigned To para que cada comercial lea el suyo.Update an opportunity
opportunity.updateLo que ves en n8n
Notas y casos de uso
Mueve un negocio: otra etapa, otro estado, otro valor o un responsable distinto.
Parámetros clave
- Opportunity ID: el negocio que se modifica. El nodo avisa de que el identificador de pipeline de una oportunidad no se puede actualizar.
- Update Fields: 6 campos, entre ellos Status, Stage Name or ID, Monetary Value, Assigned To y Name.
won y el importe definitivo entra en Monetary Value, sin arrastrar tarjetas a mano.Task
5 operacionesCreate a task
task.createLo que ves en n8n
Notas y casos de uso
Cuelga una tarea de un contacto, con fecha límite. Aquí hay cuatro campos requeridos, más que en la mayoría de operaciones de este nodo.
Parámetros clave
- Contact Email or ID: el contacto al que pertenece la tarea, de la lista o como ID.
- Title: lo que hay que hacer.
- Due Date: la fecha y la hora límite.
- Completed: booleano requerido, así que n8n pide su valor incluso en una tarea recién abierta.
- Body: el detalle, dentro de Additional Fields junto a Assigned To.
Delete a task
task.deleteLo que ves en n8n
Notas y casos de uso
Quita una tarea que ha perdido su motivo de existir. Hacen falta dos identificadores, porque las tareas cuelgan siempre de un contacto.
Parámetros clave
- Contact Email or ID: el contacto al que pertenece la tarea.
- Task ID: cuál de sus tareas se va.
Get a task
task.getLo que ves en n8n
Notas y casos de uso
Recoge una tarea concreta de un contacto y pasa lo que encuentra al resto del flujo.
Parámetros clave
- Contact Email or ID: el contacto que guarda la tarea.
- Task ID: la tarea que se lee.
Get many tasks
task.getAllLo que ves en n8n
Notas y casos de uso
Las tareas de un contacto vuelven como lista. Aquí el contacto es obligatorio, de modo que el resultado siempre queda acotado a una sola persona.
Parámetros clave
- Contact Email or ID: requerido, el contacto cuyas tareas se devuelven.
- Return All: activado, vuelven todas las tareas de ese contacto; desactivado, Limit fija cuántas.
Update a task
task.updateLo que ves en n8n
Notas y casos de uso
Reescribe una tarea en su sitio: otra fecha límite, otro responsable o la marca que la cierra.
Parámetros clave
- Contact Email or ID y Task ID: la pareja que señala la tarea.
- Update Fields: 5 campos, Completed, Title, Body, Due Date y Assigned To.
Calendar
2 operacionesBook appointment in a calendar
calendar.bookAppointmentLo que ves en n8n
Notas y casos de uso
Reserva un hueco en un calendario de HighLevel para un contacto, sin que nadie abra una página de reservas.
Parámetros clave
- Calendar ID: qué calendario recibe la cita.
- Location ID: el identificador de ubicación que el nodo pide junto al anterior.
- Contact ID: para quién es la cita.
- Start Time: una cadena con la fecha, la hora y el desfase horario, con la forma
2021-06-23T03:30:00+05:30. End Time sigue la misma forma dentro de Additional Fields. - Appointment Status: opcional, con los valores permitidos
new,confirmed,cancelled,showed,noshoweinvalid.
Get free slots of a calendar
calendar.getFreeSlotsLo que ves en n8n
Notas y casos de uso
Pregunta a un calendario qué huecos siguen libres dentro de la ventana que definas, que es el paso previo a proponer horas a alguien.
Parámetros clave
- Calendar ID: el calendario que se consulta.
- Start Date y End Date: los límites de la ventana, en formato numérico. El nodo da
1548898600000y1601490599999como ejemplos. - Timezone: la zona horaria de los huecos devueltos,
America/Chihuahuapor ejemplo, dentro de Additional Fields junto a User ID.
¿Necesitas ayuda para automatizar HighLevel con n8n?
El equipo te responde directamente.
Cada mensaje lo lee una persona.

