Contenido del curso
Controla n8n con su API REST
¿Y si pudieras controlar n8n desde otro sistema sin tocar la interfaz ni abrir una terminal? La API REST de n8n te permite gestionar workflows, ejecuciones, usuarios y credenciales desde fuera de la plataforma, ideal para integraciones, scripts externos y herramientas personalizadas que usen n8n como motor de automatización.
Esta API está disponible tanto en la versión cloud como en self-hosted, viene activa por defecto y se puede consumir desde herramientas como Postman, cURL o incluso desde un workflow del propio n8n.
¿Qué puedes hacer con la API REST de n8n?
La API expone los recursos principales de la plataforma como endpoints HTTP, lo que te da control programático sobre casi cualquier operación que harías a mano.
¿Para qué sirve la API REST de n8n? Sirve para controlar n8n desde otros sistemas: lanzar workflows, crear usuarios o consultar ejecuciones sin usar la interfaz gráfica. Es la puerta de entrada para integrar n8n con tu stack externo.
¿Cómo crear un API Key en n8n para autenticarte?
Antes de llamar a cualquier endpoint necesitas una clave de autenticación. n8n usa un esquema de API Key que viaja en una cabecera personalizada.
¿Dónde se genera la API Key dentro de n8n?
Desde la pantalla de inicio, abre los tres puntos en la parte inferior y entra a Settings. Ahí busca la sección n8n API y haz clic en Create an API Key [01:30].
Al crear la clave puedes definir tres cosas importantes:
No recomiendo tokens sin expiración. Tienes que poder rotar tus API Keys y revisar el scope uno por uno, dejando solo lo imprescindible para esa integración.
¿Cómo conectar la API Key dentro de un workflow de n8n?
El propio n8n tiene un nodo nativo para llamar a su API. Crea un trigger manual, agrega un nodo n8n y elige la acción Get many workflows [02:45].
En las credenciales pega tu API Key y define la Base URL. En local sería http://localhost:5678, y en producción tu dominio real. Recuerda que la ruta de la API siempre va seguida de /api/v1. Al ejecutar verás listados los workflows existentes.
¿Cómo probar la API REST de n8n con Postman?
Postman es perfecto para experimentar con los endpoints antes de integrarlos en código. La configuración base es la misma para cualquier llamada.
Define la URL como http://localhost:5678/api/v1 seguida del recurso que quieras consultar. En la pestaña Authorization elige el tipo API Key y completa los dos valores [04:10].
¿Qué cabecera usa la API de n8n para autenticar? Usa la cabecera
X-N8N-API-Keycon el valor del token que generaste en Settings. Sin ella, todas las llamadas devuelven error de autorización.
¿Cómo listar usuarios con un GET a /users?
Apunta tu petición a /users con método GET y dale a Send. La respuesta trae el listado completo de usuarios registrados en la instancia, útil para auditorías o para sincronizar con un sistema externo.
¿Cómo crear usuarios con POST y JSON en el body?
Cambia el método a POST sobre el mismo /users. En la pestaña Body selecciona raw y formato JSON. La API de n8n acepta un array de objetos con dos parámetros por usuario: email y role [06:00].
Un detalle clave: crear usuarios de tipo Global Admin requiere licencia n8n Enterprise. Con la licencia gratuita debes usar el rol member. Al enviar la petición, el usuario aparece en estado pending hasta que confirme el correo de invitación.
¿Por qué integrar n8n vía API en lugar de la interfaz?
La interfaz gráfica es genial para diseñar, pero hay escenarios donde necesitas que n8n sea una pieza más de un sistema mayor.
En todos estos casos, la API REST te ahorra clicks y convierte a n8n en una plataforma verdaderamente headless.
¿Ya pensaste qué proceso de tu día a día podrías disparar desde fuera de n8n? Cuéntame en los comentarios qué integración quieres montar primero.
