flowtemplates

n8n · tutorial · verificado el 6 de septiembre de 2026

Cómo importar una plantilla de n8n

Una plantilla de n8n es un archivo JSON de flujo corriente, y hay dos formas de meterlo: copiar el JSON y pegarlo con Ctrl+V (Cmd+V en Mac) sobre un lienzo vacío, o abrir el menú de tres puntos arriba a la derecha y elegir «Import from File» o «Import from URL». Cualquiera de las dos tarda menos de un minuto.

Dos advertencias antes de empezar. El editor de n8n está en inglés: en el repositorio de n8n solo hay un archivo de idioma, en.json, así que los menús se llaman «Download», «Import from File» e «Import from URL» aunque su navegador esté en español. Y los avisos de credenciales que aparecen después de importar son normales, no un fallo: la plantilla solo trae marcadores de posición.

Los siete pasos

  1. Consiga el JSON del flujoEn la página de una plantilla, pulse Copy JSON o descargue el archivo .json. Nuestros archivos están saneados: ni claves reales ni tokens, solo marcadores como {{YOUR_SLACK_CREDENTIAL}}.
  2. Abra un flujo vacíoEn Workflows, cree uno nuevo. Importe siempre sobre un lienzo vacío: la importación añade nodos al lienzo actual, no lo sustituye.
  3. Pegue o importeHaga clic en el lienzo y pulse Ctrl+V, o use ⋯ → «Import from File» y elija el archivo. n8n reconstruye todos los nodos y sus conexiones.
  4. Reconecte sus credencialesCada nodo marcado se abre con un campo de credencial. Cree una nueva o seleccione una existente y autentíquese con su propia cuenta.
  5. Ajuste los parámetrosPonga lo que es suyo: el ID de una hoja de cálculo, un canal de Slack, una carpeta, una ruta de webhook. La tabla de cada página de plantilla dice exactamente qué rellenar.
  6. Ejecute una vezCon Execute Workflow, lance una prueba con datos de ejemplo y confirme que todos los nodos se ponen en verde.
  7. Publique el flujoHasta ese momento n8n no registra los webhooks de producción ni arranca las programaciones. Si tras publicar la llamada devuelve 404, siga «webhook no registrado».

Qué contiene el archivo y qué conviene borrar antes de compartirlo

El JSON describe nodos, parámetros y conexiones, y no incluye los valores de las credenciales. Pero la documentación de n8n es más precisa que la mayoría de guías: los archivos exportados contienen nombres e identificadores de credenciales. Los identificadores no suponen riesgo; los nombres pueden serlo, según cómo los haya bautizado. n8n añade además que los nodos HTTP Request importados desde un comando cURL pueden llevar cabeceras de autenticación.

La consecuencia práctica es sencilla: revise cualquier exportación propia antes de pegarla en un foro, un ticket o un repositorio público. Nuestro validador de JSON de flujos hace ese repaso en el navegador — busca patrones de claves y tokens y enumera los tipos de credencial referenciados, sin enviar el archivo a ningún sitio.

Si la importación falla, el mensaje decide

n8n usa frases distintas para causas distintas. Lea la que le ha salido antes de tocar el archivo.

  • «Could not import file» / «The file does not contain valid JSON data»El archivo no es JSON válido. Casi siempre una coma de más o comillas tipográficas que se colaron al copiar desde un chat o un documento.
  • «The imported data does not contain valid workflow data (‘nodes’ and ‘connections’ are missing)»JSON válido, forma equivocada. Suele ser un único nodo copiado o una respuesta de la API con el flujo todavía envuelto en un objeto data.
  • «Skipped N node(s) with missing type»La importación funcionó, pero su instancia no conoce esos tipos de nodo: casi siempre nodos de la comunidad que hay que instalar antes.
  • En la terminal: <code>SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id</code>Reproducido en n8n 2.25.7: n8n import:workflow exige un campo id de primer nivel y el editor no. Añada cualquier cadena única como "id".

Los ocho mensajes —cuatro del editor y cuatro de la terminal— con su causa y su arreglo están en «no se pudo importar el archivo».

Importar desde la terminal

Para instancias autoalojadas, n8n documenta n8n import:workflow --input=archivo.json y --separate --input=directorio/ para una carpeta entera. Por defecto, import:workflow deja desactivado todo lo que importa; con --activeState=fromJson conserva el campo active de cada archivo, opción que según la documentación solo se admite en modo multi-main y de cola.

Dos diferencias con el editor. La primera, el campo id ya comentado. La segunda, más práctica: para un solo flujo, pegar es más rápido que abrir una terminal. Si todavía no tiene instancia, el montaje está en la guía de n8n autoalojado.

Fuentes y fecha de verificación

Los nombres de menú y las reglas de importación proceden de la documentación de n8n, leída el 6 de septiembre de 2026; los errores de terminal los reprodujimos ese mismo día en n8n 2.25.7 sobre Docker.

Preguntas frecuentes

¿Dónde está «Import from File» en n8n?

En el menú de tres puntos (⋯) de la esquina superior derecha del editor de flujos. Según la documentación de n8n, allí están «Import from URL» e «Import from File», y por la misma vía se exporta con «Download». También puede pegar el JSON copiado directamente sobre el lienzo con Ctrl+V o Cmd+V.

¿Por qué salen errores de credenciales después de importar?

Porque es lo esperado. Las plantillas solo llevan marcadores de posición, así que n8n señala cada nodo afectado hasta que usted conecta su propia cuenta. Abra los nodos marcados y cree o elija una credencial. No es una importación fallida.

¿La importación sobrescribe mis flujos actuales?

No. La importación coloca los nodos en el lienzo que tenga abierto. Importe sobre un flujo nuevo y vacío si quiere mantenerlo separado; de lo contrario, los nodos nuevos aparecerán junto a los que ya había.

¿Es seguro pegar un JSON de flujo de otra persona?

El archivo describe nodos, parámetros y conexiones, y no lleva valores de credenciales. Aun así, la documentación de n8n advierte de que las exportaciones contienen nombres e identificadores de credenciales, y de que los nodos HTTP Request importados desde cURL pueden incluir cabeceras de autenticación. Revise los archivos ajenos antes de ejecutarlos y los propios antes de compartirlos.

¿Puedo importar una carpeta entera de flujos de una vez?

Sí, pero solo desde la terminal: n8n import:workflow --separate --input=<directorio>. Por defecto todos los flujos importados quedan desactivados; con --activeState=fromJson n8n respeta el campo active de cada archivo, opción que la documentación limita a los modos multi-main y de cola.

¿Por qué el mismo archivo entra por el editor y no por la terminal?

Porque la terminal escribe directamente en la base de datos. En n8n 2.25.7 un JSON sin campo «id» de primer nivel falló con SQLITE_CONSTRAINT: NOT NULL constraint failed: workflow_entity.id, y al añadir un «id» el mismo archivo se importó sin problemas. Los archivos de plantilla saneados suelen no llevar ese campo a propósito.