La n8n API REST te permite gestionar y controlar todos los aspectos de tu instancia de n8n desde código externo, sin necesidad de abrir el panel visual. Podés listar workflows, activarlos o desactivarlos, disparar ejecuciones y obtener resultados de forma completamente programática. Si estás buscando integrar n8n en sistemas más grandes, construir dashboards de monitoreo o automatizar la gestión de tus flujos de trabajo, dominar la n8n API REST es el camino.

En esta guía te mostramos cómo usar la n8n API REST de forma práctica: qué endpoints están disponibles, cómo autenticarte correctamente y cuáles son los casos de uso más interesantes con ejemplos reales. Si querés llevar el control de tu instancia al siguiente nivel, esta guía es para vos.

¿Qué es la n8n API REST y para qué sirve?

La n8n API REST es una interfaz programática que expone todas las funcionalidades del panel de n8n a través de endpoints HTTP estándar. Esto significa que todo lo que hacés manualmente en la interfaz visual, lo podés automatizar desde cualquier lenguaje de programación o herramienta que haga solicitudes HTTP.

Las capacidades principales incluyen:

• Gestión de workflows: listar, crear, actualizar, activar, desactivar y eliminar workflows.
• Ejecuciones: disparar workflows con datos personalizados, listar ejecuciones pasadas, obtener resultados y detener ejecuciones en curso.
• Credenciales: listar y gestionar las credenciales configuradas en n8n (sin exponer valores sensibles).
• Tags y organización: crear y listar tags para mantener tus workflows organizados.
• Usuarios y configuración: gestionar usuarios en instancias enterprise y consultar la configuración de la instancia.

Casos de uso típicos de la n8n API REST

• Integrar n8n en un dashboard de monitoreo interno.
• Disparar workflows desde tu aplicación web sin usar webhooks públicos.
• Automatizar el despliegue de workflows entre entornos (desarrollo, staging, producción).
• Construir herramientas de administración personalizadas para tu equipo.
• Implementar flujos de CI/CD para tus automatizaciones.

Si todavía estás dando tus primeros pasos con la plataforma, te recomiendo empezar por nuestra guía de qué es n8n y cómo funciona antes de sumergirte en la API.

Autenticación en la n8n API REST

Para usar la n8n API REST necesitás autenticarte con una API Key. El proceso es sencillo:

1. En n8n, andá a Settings → n8n API (o a tu perfil → API Keys en versiones anteriores).
2. Hacé clic en «Create an API Key» y dale un nombre descriptivo.
3. Copiá el valor generado y guardalo en un lugar seguro.

Para autenticarte, incluí este header en cada solicitud HTTP:

X-N8N-API-KEY: tu_api_key_aqui

La URL base de la API depende de tu tipo de instalación:

• n8n Cloud: https://tu-instancia.n8n.cloud/api/v1/
• Self-hosted: https://tu-dominio.com/api/v1/

Si usás n8n Cloud, la documentación interactiva (tipo Swagger) está disponible en https://tu-instancia.n8n.cloud/api/v1/docs. Te recomiendo explorarla porque podés probar endpoints directamente desde el navegador.

Endpoints principales de la n8n API REST

Estos son los endpoints más utilizados de la n8n API REST, organizados por recurso. Consultá la documentación oficial de la API de n8n para ver la referencia completa.

Workflows

GET    /workflows              — Listar todos los workflows
GET    /workflows/{id}         — Obtener detalles de un workflow
POST   /workflows              — Crear un nuevo workflow
PATCH  /workflows/{id}         — Actualizar un workflow existente
POST   /workflows/{id}/activate    — Activar workflow
POST   /workflows/{id}/deactivate  — Desactivar workflow
DELETE /workflows/{id}         — Eliminar workflow

Ejecuciones

GET    /executions              — Listar ejecuciones (filtros por workflow, estado, fecha)
GET    /executions/{id}         — Obtener detalles y resultado de una ejecución
DELETE /executions/{id}         — Eliminar registro de ejecución

Credenciales y Tags

GET    /credentials             — Listar credenciales
POST   /credentials             — Crear credencial
DELETE /credentials/{id}        — Eliminar credencial
GET    /tags                    — Listar tags
POST   /tags                    — Crear tag

Ejemplo práctico: Disparar workflows con la n8n API REST

Una de las aplicaciones más útiles de la n8n API REST es disparar workflows directamente desde tu aplicación o script, sin necesidad de configurar webhooks públicos expuestos a internet.

Para que esto funcione, el workflow debe estar configurado con un trigger compatible. Luego hacés una solicitud POST así:

POST /workflows/{workflowId}/run
Content-Type: application/json
X-N8N-API-KEY: tu_api_key

{
  "workflowData": {
    "id": "workflowId"
  },
  "inputData": {
    "main": [[
      {
        "json": {
          "nombre": "Juan",
          "accion": "procesar_pedido"
        }
      }
    ]]
  }
}

Esta llamada dispara el workflow con los datos que enviás como input y devuelve el ID de la ejecución. Después podés hacer polling al endpoint GET /executions/{executionId} para esperar el resultado.

Un ejemplo con curl para listar todos tus workflows:

curl -X GET "https://tu-instancia.n8n.cloud/api/v1/workflows" \
  -H "X-N8N-API-KEY: tu_api_key" \
  -H "Accept: application/json"

Este patrón es especialmente útil cuando querés integrar n8n como motor de automatización de tu aplicación: el usuario hace una acción en tu app, tu backend llama a la API de n8n para ejecutar el workflow correspondiente y espera el resultado. Todo sin exponer endpoints públicos.

Si necesitás conectar n8n con servicios externos de forma más avanzada, revisá nuestra guía sobre nodos e integraciones disponibles en n8n.

Dashboard de monitoreo con la n8n API REST

Otro caso de uso potente es construir un dashboard personalizado que muestre el estado de todos tus workflows y ejecuciones recientes usando la n8n API REST.

Con una simple aplicación web o script en Python/JavaScript, podés:

1. Listar todos los workflows y su estado (activo/inactivo) con GET /workflows.
2. Obtener las últimas 50 ejecuciones con su resultado (éxito/error) con GET /executions?limit=50.
3. Calcular la tasa de éxito y tiempo promedio de ejecución procesando los datos de respuesta.
4. Enviar alertas automáticas (email, Slack, Telegram) cuando la tasa de errores supera un umbral.

Este dashboard te da visibilidad completa sobre la salud de tus automatizaciones sin necesidad de entrar al panel de n8n cada vez. Es particularmente valioso en equipos donde varias personas trabajan con workflows y necesitás un punto centralizado de monitoreo.

Workflows as Code: Gestión versionada con la n8n API REST

La n8n API REST permite implementar un flujo de «workflows as code» donde guardás los JSON de tus workflows en un repositorio Git y usás scripts automatizados para desplegarlos entre entornos.

El flujo típico sería:

1. Exportar: usás GET /workflows/{id} para descargar el JSON del workflow desde el entorno de desarrollo.
2. Versionar: guardás ese JSON en tu repositorio Git con un commit descriptivo.
3. Revisar: tu equipo hace code review del cambio como con cualquier otro código.
4. Desplegar: un script en tu pipeline de CI/CD usa POST /workflows o PATCH /workflows/{id} para importar el workflow en producción.
5. Activar: el mismo script llama a POST /workflows/{id}/activate para dejarlo funcionando.

Este enfoque te da trazabilidad completa de los cambios, posibilidad de hacer rollback y un proceso de despliegue profesional para tus automatizaciones.

Buenas prácticas de seguridad con la n8n API REST

Cuando trabajás con la n8n API REST, la seguridad es fundamental. Estas son las prácticas que te recomiendo seguir:

• Nunca expongas tu API Key en código público: usá variables de entorno o un gestor de secretos para almacenarla.
• Rotá las API Keys periódicamente: creá una nueva key, actualizá tus integraciones y eliminá la anterior.
• Restringí el acceso por red: si tu instancia es self-hosted, configurá reglas de firewall para que solo IPs autorizadas accedan a la API.
• Usá siempre HTTPS: nunca hagas llamadas a la API sin cifrado TLS, especialmente en producción.
• Auditá el uso: revisá periódicamente las ejecuciones y accesos para detectar actividad sospechosa.
• Creá keys separadas por servicio: si tenés múltiples integraciones, usá una API Key diferente para cada una.

Para aprender más sobre cómo configurar tu instancia de forma segura, podés leer nuestra guía de instalación y configuración de n8n.

Limitaciones y rate limiting de la n8n API REST

Es importante conocer las limitaciones actuales de la n8n API REST para evitar sorpresas:

• Rate limiting: n8n Cloud aplica límites de tasa en las solicitudes a la API. Si hacés demasiadas llamadas en poco tiempo, vas a recibir respuestas con código 429 (Too Many Requests).
• Paginación: los endpoints que devuelven listas (workflows, ejecuciones) usan paginación. Asegurate de manejar los parámetros limit y cursor en tus scripts.
• Versión de la API: actualmente la API está en v1. Revisá la documentación oficial de n8n periódicamente para enterarte de cambios o nuevas versiones.
• Endpoints en evolución: algunos endpoints pueden cambiar entre versiones de n8n. Si hacés self-hosting, tené en cuenta esto al actualizar.

Preguntas frecuentes sobre la n8n API REST

¿La n8n API REST está disponible en la versión gratuita?

Sí. La API REST está disponible tanto en n8n Cloud (todos los planes) como en la versión self-hosted community. Los endpoints disponibles pueden variar según la versión y el plan que uses.

¿Puedo usar la n8n API REST para migrar workflows entre instancias?

Sí, y es uno de los casos de uso más comunes. Exportás el JSON de un workflow con GET /workflows/{id} desde una instancia y lo importás con POST /workflows en otra. Solo tené en cuenta que las credenciales no se transfieren automáticamente.

¿Es seguro exponer la n8n API REST a internet?

Si usás n8n Cloud, la seguridad viene gestionada por el equipo de n8n. Para instalaciones self-hosted, es recomendable proteger el acceso con firewall, VPN o reverse proxy con autenticación adicional. Nunca expongas la API sin autenticación a internet público.

¿Vale la pena? Nuestra opinión

La n8n API REST abre un mundo de posibilidades para gestionar tus automatizaciones de forma profesional y programática. Ya sea que necesites integrar n8n en tu aplicación, construir un dashboard de monitoreo o implementar un pipeline de CI/CD para tus workflows, la API te da las herramientas necesarias.

Lo más importante es empezar con algo simple — como listar tus workflows desde un script — e ir construyendo complejidad a medida que lo necesites. La documentación interactiva de n8n es tu mejor amiga para explorar y probar endpoints antes de escribir código definitivo.