Recursos · Integración n8n

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

Por qué automatizar

¿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.

Conexión

¿Cómo se conecta HighLevel con n8n?

  1. 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ó.

  2. 02

    Declarar los scopes y la URL de redirección

    La app lleva seis scopes: locations.readonly, contacts.readonly, contacts.write, opportunities.readonly, opportunities.write y users.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.

  3. 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.

Acciones

¿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.

Matriz recursos × operaciones
RecursoCreate or UpdateGetGet ManyUpdateDeleteBook AppointmentGet Free Slots
Contact✓✓✓✓✓
Opportunity✓✓✓✓✓
Task✓✓✓✓✓
Calendar✓✓

Contact

5 operaciones
01

Create or update a contact

contact.create

Lo 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.
Casos de uso
una descarga de guía entra en n8n y la ficha ya existe en HighLevel antes de que salga el correo con el enlace.
02

Delete a contact

contact.delete

Lo 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.
Casos de uso
llega una petición de borrado a un buzón compartido, el flujo localiza a la persona con Get Many y limpia la ficha correspondiente sin que nadie abra HighLevel.
03

Get a contact

contact.get

Lo 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.
Casos de uso
antes de generar un presupuesto, el flujo trae el contacto para que el documento salga con lo que guarda HighLevel y no con lo que alguien tecleó en un formulario.
04

Get many contacts

contact.getAll

Lo 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_added o date_updated, ascendente (asc) o descendente (desc).
Casos de uso
un repaso semanal ordenado por date_added con Return All activado, que alimenta el panel del equipo comercial.
05

Update a contact

contact.update

Lo 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.
Casos de uso
un cliente cambia de número durante una llamada de soporte, el flujo actualiza Phone y la ficha queda correcta antes de la siguiente campaña.

Opportunity

5 operaciones
06

Create an opportunity

opportunity.create

Lo 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, lost y abandoned.
  • 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.
Casos de uso
un lead pide precio desde la web y el negocio nace en open con Monetary Value tomado del importe estimado.
07

Delete an opportunity

opportunity.delete

Lo 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ó.
Casos de uso
una migración desde otra herramienta dejó negocios repetidos; una operación de lista los recoge y esta los quita en la misma ejecución.
08

Get an opportunity

opportunity.get

Lo 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.
Casos de uso
alguien pregunta por el estado de un negocio desde un canal de equipo y el flujo responde con lo que hay guardado en HighLevel, sin que nadie abra el pipeline.
09

Get many opportunities

opportunity.getAll

Lo 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, lost o abandoned.
Casos de uso
el resumen del lunes con los negocios que siguen en open dentro de un pipeline, repartido por Assigned To para que cada comercial lea el suyo.
10

Update an opportunity

opportunity.update

Lo 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.
Casos de uso
el equipo cierra la venta en la propia llamada, Status pasa a won y el importe definitivo entra en Monetary Value, sin arrastrar tarjetas a mano.

Task

5 operaciones
11

Create a task

task.create

Lo 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.
Casos de uso
termina una visita comercial y la tarea de seguimiento ya espera en la ficha del contacto con su Due Date.
12

Delete a task

task.delete

Lo 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.
Casos de uso
se anula una reunión y la tarea de preparación desaparece en la misma ejecución que envía el mensaje de disculpa al cliente.
13

Get a task

task.get

Lo 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.
Casos de uso
una revisión diaria lee las tareas que el flujo creó la víspera y encamina cada una según lo que vuelve, así la lógica de recordatorios vive en n8n y no en la cabeza de alguien.
14

Get many tasks

task.getAll

Lo 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.
Casos de uso
una revisión de cuenta recorre unos cuantos contactos y saca las tareas de cada uno, así la reunión empieza por lo que de verdad sigue pendiente.
15

Update a task

task.update

Lo 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.
Casos de uso
se registra una llamada en otra herramienta, el flujo marca Completed en la tarea correspondiente y empuja la Due Date del seguimiento un poco más adelante.

Calendar

2 operaciones
16

Book appointment in a calendar

calendar.bookAppointment

Lo 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, noshow e invalid.
Casos de uso
un cliente elige hora en una página externa y la cita aparece en el calendario correcto con su Title antes de que cierre la pestaña.
17

Get free slots of a calendar

calendar.getFreeSlots

Lo 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 1548898600000 y 1601490599999 como ejemplos.
  • Timezone: la zona horaria de los huecos devueltos, America/Chihuahua por ejemplo, dentro de Additional Fields junto a User ID.
Casos de uso
entra una petición de llamada y la respuesta sale con 3 huecos reales en lugar de una cadena de correos.
Necesitas ayuda

¿Necesitas ayuda para automatizar HighLevel con n8n?

El equipo te responde directamente.

Cada mensaje lo lee una persona.

FAQ

HighLevel y n8n, las preguntas que vienen después

01¿La integración HighLevel n8n es gratuita?
Por el lado de n8n, sí. El nodo HighLevel viene instalado con n8n, así que no hay nada que instalar ni nada extra que pagar para usarlo, tanto en n8n Cloud como en una instancia autoalojada bajo la Community Edition y su licencia Sustainable Use. Un flujo se comporta igual en los dos sitios, de modo que puedes probarlo en uno y llevarlo al otro sin reescribir los pasos de HighLevel. Las 17 operaciones, los 4 recursos y la credencial OAuth2 forman parte de la instalación estándar. Lo que pagues a HighLevel por tu propia cuenta es otro asunto, que se resuelve en su lado.
02¿Qué credenciales y permisos hacen falta para HighLevel?
OAuth2, en la práctica. La página de credenciales enumera dos métodos: una clave de API, que va con la API v1, y OAuth2, que va con la API v2. HighLevel dejó obsoleta la API v1.0 y ya no la mantiene, así que las credenciales nuevas se montan con OAuth2. Eso significa una cuenta de desarrollador en el marketplace de HighLevel, una app creada desde My Apps con Distribution Type en Sub-Account, y seis scopes: locations.readonly, contacts.readonly, contacts.write, opportunities.readonly, opportunities.write y users.readonly. Después se intercambian dos cosas: la OAuth Redirect URL de n8n entra en la app, y el Client ID y el Client Secret entran en la credencial de n8n, con esos mismos scopes en una lista separada por espacios.
03¿Qué límites tiene el nodo HighLevel en n8n?
Tres cosas marcan lo que puede hacer un flujo. La paginación, primero: en las operaciones de lista, Return All trae todos los registros que coinciden encadenando las páginas de la API, y si lo dejas desactivado es Limit quien fija el número máximo de items devueltos. Los campos requeridos, después: un campo marcado como requerido bloquea la ejecución del nodo si está vacío, así que un Contact ID o un Opportunity ID que falta detiene la ejecución en lugar de adivinar. Las reglas del propio nodo, al final: solo puede haber una oportunidad por contacto, y el identificador de pipeline de una oportunidad no se puede actualizar. Para lo que quede fuera de las 17 operaciones, el nodo HTTP Request llama a cualquier endpoint de la API de HighLevel reutilizando la misma credencial mediante la autenticación predefinida.
04¿Puede un evento de HighLevel arrancar un flujo de n8n al momento?
Desde HighLevel, no. Esta herramienta no tiene nodo trigger en n8n, así que un flujo que la toque empieza en otro sitio. Tres caminos cubren casi todos los casos. Un Schedule Trigger ejecuta el flujo a intervalo fijo, algo que encaja con los informes y las tareas de limpieza montadas sobre las operaciones Get Many. Un Webhook de n8n, es decir una URL que n8n expone para que otro servicio le envíe datos, sirve cuando algo externo tiene que lanzar la ejecución en el mismo instante en que ocurre. O el trigger de otra herramienta abre el flujo y HighLevel pasa a ser el paso que crea el contacto, mueve el negocio o reserva el hueco.
05¿n8n o Make para HighLevel?
La decisión se juega en cuatro criterios, y ninguna de las dos respuestas está mal. El alojamiento: n8n se autoaloja con Docker o npm, o se usa en n8n Cloud; Make es una plataforma alojada, sin opción de autoalojamiento. El control de los datos viene de ahí, porque una instancia autoalojada mantiene los datos de contacto de HighLevel dentro de una infraestructura que es tuya. El modelo de coste: Make factura por operación, algo que conviene calcular sobre un flujo que recorre los resultados de Get Many uno a uno. La lógica visual: las dos dibujan el flujo en un lienzo, y ahí la preferencia es sobre todo costumbre. Mide el volumen que esperas y dónde pueden vivir los datos, y elige.