Cómo crear tu primer workflow en n8n paso a paso

Vamos a construir un workflow sencillo que puedes ejecutar una y otra vez sin depender de claves, cuentas ni servicios externos: empezará de forma manual, creará unos datos de ejemplo, los transformará y te mostrará el resultado. El objetivo es entender cómo funcionan los nodos, las conexiones y los datos en n8n antes de tocar webhooks, APIs o credenciales.

Qué vamos a crear

El flujo será un pequeño circuito de tres nodos:

Manual Trigger: inicia el workflow cuando tú lo decides.
Edit Fields: crea los datos de ejemplo.
Edit Fields: transforma esos datos.

No va a resolver todavía ningún problema de automatización de verdad. Su propósito es que veas con tus propios ojos cómo se mueven los datos de un nodo a otro, que es la base de todo lo que harás después en n8n.

Requisitos previos

Necesitas una instancia de n8n funcionando y acceso a su editor web. Si todavía no la tienes, sigue primero la guía de cómo instalar n8n con Docker; aquí no repetimos la instalación.

Crear un nuevo workflow

Al entrar en n8n, en la sección Workflows pulsa el botón para crear uno nuevo. Se abrirá el lienzo (canvas): un espacio en blanco donde se construye el flujo.

En n8n todo se compone de dos elementos:

Nodo: cada paso del workflow (una acción o un disparador).
Conexión: la línea que une dos nodos y por la que viajan los datos, siempre de izquierda a derecha: el nodo de la izquierda alimenta al de la derecha.

Al crear un workflow nuevo, añade un Manual Trigger como primer nodo si todavía no aparece uno en el lienzo.

Añadir el nodo de inicio

Sobre el lienzo, pulsa en el signo + o en el nodo de inicio y busca Manual Trigger para añadirlo.

Este nodo no hace nada por sí mismo: simplemente te permite ejecutar el workflow manualmente durante las pruebas. No necesita configuración.

Ten claro desde ya que en workflows reales el disparador suele ser otra cosa: un webhook, un horario, un evento de otra aplicación o cualquier otro trigger. Aquí usamos el manual para poder probar sin depender de nada externo.

Añadir datos de ejemplo

Conectado al Manual Trigger, añade un nodo Edit Fields. Este nodo (en versiones antiguas de n8n se llamaba Set) sirve para crear y modificar datos de forma visual.

En su configuración, en Fields to Set, añade estos campos manualmente:

Name	Value
`nombre`	`Mateo`
`servicio`	`Automatización`
`estado`	`prueba`

Al salir de este nodo, los datos serán ese pequeño objeto JSON. Es la primera vez que ves cómo un nodo “crea” información para que el siguiente la aproveche.

Conectar los nodos

Arrastra una conexión desde la salida del Manual Trigger hasta la entrada del nodo Edit Fields. Si añades Edit Fields directamente desde el botón + del trigger, n8n crea la conexión automáticamente.

Recuerda la dirección: el flujo va de izquierda a derecha. El Manual Trigger está a la izquierda, sus datos entran al primer Edit Fields, y de ahí pasarán al siguiente nodo.

Ejecutar el workflow

Pulsa el botón Test Workflow en la parte inferior del editor. El workflow se ejecuta de principio a fin y verás cómo cada nodo se va marcando:

El Manual Trigger se ejecuta y entrega datos.
El primer Edit Fields se ejecuta y crea los tres campos.
El segundo Edit Fields (si ya está conectado) se ejecuta y recibe esos datos.

Cada nodo que termina sin problemas queda marcado como correcto. Si alguno falla, se marca con un error — lo veremos más adelante.

Entender los datos entre nodos

En n8n, los datos viajan en unidades llamadas items. Cada item es un objeto de información que un nodo entrega; por defecto se representa como JSON.

Selecciona el primer nodo Edit Fields y en el panel de la derecha abre su output (salida). Verás algo similar a:

{
  "nombre": "Mateo",
  "servicio": "Automatización",
  "estado": "prueba"
}

Ese JSON es exactamente lo que recibe el siguiente nodo como input (entrada). Cada nodo tiene dos vistas para inspeccionar: su input (lo que recibe del anterior) y su output (lo que entrega al siguiente). Acostumbrarte a mirarlas evita la mayoría de los fallos de principiante.

De momento manejamos un solo item con tres campos. Más adelante verás workflows con muchos items y estructuras anidadas; la idea de fondo es la misma.

Transformar los datos

Añade un segundo nodo Edit Fields después del primero. Va a modificar los datos en lugar de crearlos desde cero.

Configura sus campos así:

Name	Value
`estado`	`completado`
`mensaje`	`Workflow ejecutado correctamente`

Con esto sobreescribes estado y añades un campo nuevo llamado mensaje. Si tienes el nodo abierto, puedes arrastrar el valor de nombre desde el panel de input para ver cómo se inserta la expresión automáticamente; para este ejemplo lo dejamos tal cual.

Ejecuta otra vez con Test Workflow. La entrada de este segundo nodo era:

nombre = Mateo
estado = prueba

Y su salida es:

nombre = Mateo
estado = completado
mensaje = Workflow ejecutado correctamente

Ver el resultado final

Haz clic en el último nodo (el segundo Edit Fields) y revisa su output. Comprueba que los datos han cambiado respecto al nodo anterior: estado ya no vale prueba, y aparece mensaje.

Este es el momento clave: el workflow completo funcionó y los datos se transformaron en cada paso. Si no ves el resultado esperado, identifica en qué nodo se produce la diferencia revisando el output de cada uno.

Guardar el workflow

Todavía no está guardado. En el editor:

Haz clic en el nombre del workflow en la parte superior (suele decir “My workflow” o un nombre genérico).
Escribe Mi primer workflow.
Confirma con Enter y pulsa el botón de guardado (el icono del disquete, normalmente en la parte superior derecha).

Desde este momento aparece en tu lista de Workflows. Si lo cierras sin guardar, perderás los nodos y conexiones que has creado.

Ejecutar vs activar

Hay una diferencia importante entre ejecutar manualmente y activar un workflow:

Ejecutar (Test Workflow) lanza el workflow cuando tú lo pides, mientras lo estás editando. Es la forma de probar y desarrollar.
Activar (toggle de Active en el editor) hace que n8n lo deje “listo” para responder automáticamente a su trigger cuando ocurra el evento que lo dispara.

Con un Manual Trigger, activar el workflow no hace que se ejecute por sí solo: un trigger manual no se dispara con el tiempo, ni con un evento, ni con una petición. Simplemente queda en modo productivo pero sin nada que lo lance. Para que la activación tenga sentido, el trigger tiene que ser de otro tipo (webhook, horario, evento de otra app), que es justo lo que veremos en los próximos pasos.

Qué ocurre cuando un nodo falla

Los fallos forman parte del proceso, y diagnosticarlos es sencillo cuando sabes dónde mirar. Si al ejecutar un nodo queda marcado con error, sigue este orden:

Abre el nodo: para ver su panel de configuración.
Revisa el mensaje de error: n8n te dice normalmente qué falló (un campo inexistente, un valor con formato incorrecto, etc.).
Mira su input: quizá el nodo anterior no entregó el dato que esperabas.
Revisa la configuración: confirma que los nombres y valores de los campos coinciden con lo que el nodo espera.

En este ejemplo, el error más típico es escribir mal un nombre de campo en Edit Fields: el workflow ejecuta pero el dato no aparece donde lo buscas. Cuando un nodo falla, el resto de la cadena no continúa con sus datos, así que el nodo en rojo te dice exactamente dónde paró.

Errores comunes de principiantes

Nodo no conectado: si al ejecutar un nodo no recibe nada, comprueba que la línea llega efectivamente desde el nodo anterior. Sin conexión, no hay datos.
Workflow no guardado: ejecutas, funciona, cierras la pestaña… y al volver ya no está. Guarda nada más terminar de probar.
Mirar la salida del nodo equivocado: todos los nodos tienen input y output. Asegúrate de que estás mirando el output del nodo que te interesa, no el del anterior.
Datos con nombres de campos distintos: si escribes Nombre con mayúscula en un nodo y el siguiente busca nombre, no los encuentra. Los nombres de campo deben coincidir exactamente.
Activar un manual trigger y esperar que se ejecute solo: no ocurrirá. Un Manual Trigger solo se ejecuta al pulsar Test Workflow. Para ejecución automática necesitas otro tipo de trigger.
La instancia no responde: si el problema no es del workflow sino de n8n en sí, revisa los logs del contenedor para ver si el servicio está funcionando.

Qué aprender después

Con este workflow ya tienes la base: disparador, nodos, conexiones, datos y ejecución. Los siguientes pasos naturales, en orden de utilidad, son:

Webhooks: para que otras aplicaciones llamen a tu workflow.
HTTP Request: para consultar APIs y traer datos externos.
Programación por horario: para ejecutar flujos cada cierto tiempo.
Credenciales y APIs: para conectar n8n con los servicios de tu entorno.
Bases de datos: para leer y guardar información de forma persistente.

Todos se apoyan en lo que acabas de hacer: un nodo recibe datos, los transforma y los entrega al siguiente.

Conclusión

Ya has creado, conectado, ejecutado, revisado y guardado tu primer workflow funcional. Sabes que los nodos reciben items del nodo anterior, los transforman y los pasan al siguiente, y sabes dónde mirar cuando algo sale mal.

El siguiente tutorial natural es Cómo usar un Webhook en n8n: verás cómo el disparador deja de ser manual y el workflow empieza a responder a llamadas externas.