Controla n8n con su API REST

Contenido del curso

Gestión avanzada de n8n

Despliegue de n8n

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:006:46

Controla n8n con su API REST

Curso de n8n Self-Hosted para Empresas

Clase 4 de 13

Clase 4 / 13

Recursos

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

Crear, leer, actualizar y eliminar workflows.
Activar o desactivar flujos sin entrar a la interfaz.
Gestionar ejecuciones, usuarios y credenciales.
Lanzar flujos desde sistemas externos como un bot o un pipeline de CI/CD.

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

Un nombre descriptivo, por ejemplo Platzi n8n.
La duración del token: 7 días, 30 días, 2 meses o sin expiración.
El scope, es decir, qué información puede leer o modificar esa key.

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-Key con 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.

Disparar workflows desde un bot de Telegram o Slack sin abrir el navegador.
Crear o actualizar workflows automáticamente desde un pipeline de CI/CD.
Construir paneles internos que usen n8n como motor de ejecución.
Aprovisionar usuarios masivamente cuando entra un equipo nuevo.

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.

Gestión avanzada de n8n

Nodos propios e infraestructura escalable en N8N

Requisitos reales del curso avanzado de n8n

Gestionar n8n desde la terminal con CLI

Controla n8n con su API REST

Cómo crear un custom node en n8n

Configuración de credenciales con API key para custom nodes en n8n

Nodo programático en n8n con execute

Publicación de custom nodes de n8n en npmjs para compartir

Despliegue de n8n

Tipos de arquitectura de n8n y cuándo usar cada una

Instalación de n8n con PostgreSQL usando Docker Compose

n8n en Queue Mode con Redis y Docker

N8n en Kubernetes con queue mode

Funcionalidades clave de N8N Enterprise

Controla n8n con su API REST

Progreso del curso

Gestión avanzada de n8n

Despliegue de n8n

Recursos

Recursos