Controla n8n sin usar la interfaz ni abrir la terminal con su API REST. Podrás crear, leer, actualizar y eliminar workflows; activarlos o desactivarlos; y gestionar ejecuciones, usuarios y credenciales. Funciona en cloud y self-hosted, está activa por defecto y se integra con Postman y herramientas como Curve. Aquí verás cómo autenticarte con una API key, configurar la Base URL y probar endpoints como /users o el listado de workflows.
¿Qué puedes hacer con la API REST de n8n?
La API permite operar tu instancia como un motor programático para integrarla con otros sistemas o scripts externos.
- Crear, leer, actualizar y eliminar workflows.
- Activar o desactivar workflows.
- Gestionar ejecuciones, usuarios y credenciales.
- Lanzar flujos desde fuera de n8n.
- Integrar con un bot o tu CI/CD.
¿Cómo crear y usar una API key en n8n?
Primero, genera una API key desde la interfaz para autenticar tus llamadas. Luego, úsala en un nodo o en un cliente HTTP.
¿Dónde crear la API key?
- Inicio, tres puntos, Settings.
- Sección n8n API.
- Create an API key y nómbrala (por ejemplo, Platzi n8n).
- Define la duración: 7 días, 3 días, 30 días, 2 meses o que no expire (no recomendado).
- Revisa el scope y deja solo lo imprescindible.
¿Cómo probar “Get Many Workflows” desde un nodo?
- Añade un trigger manual.
- Botón de más, busca n8n y elige la acción Get Many Workflows.
- Crea credenciales: pega tu API key en “API key”.
- En Base URL, usa la URL de tu instancia (ejemplo: localhost:5678) y añade /API-v1.
- Guarda y ejecuta: verás workflows como myworkflow-2 y myworkflow si todo está bien.
¿Cómo probar endpoints en Postman y gestionar usuarios?
Configura la URL, la autenticación y realiza llamadas GET y POST a /API/v1 para validar permisos y flujos de creación de usuarios.
¿Cómo configurar la autenticación en Postman?
- URL base: localhost:5678 + /API/v1.
- En Headers > Type: API key.
- Nombre de cabecera según documentación: x-n8n-api-key.
- Valor: el token que generaste.
¿Cómo obtener y crear usuarios con /users?
- Obtener usuarios: método GET a /users.
- Crear usuarios: método POST a /users con Body > raw > JSON.
- Formato: array de objetos con dos campos: email y role.
- Nota de licencia: con n8n Enterprise se admite global admin; con licencia gratuita usa member.
- Tras crear, verifica en la interfaz: Settings > users mostrará el correo (por ejemplo, user@ejemplo.com) en estado pending hasta que confirme por email.
— ¿Te gustaría que profundicemos en los nodos nativos de n8n para manipular la API o ver más ejemplos con workflows y CI/CD? Cuéntame en los comentarios qué endpoint te interesa probar.
