API REST de n8n para controlar workflows desde sistemas externos

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.