Módulo 5: Credenciales y Servicios

Configurar Credenciales de Email (SMTP)

Descripción de la cápsula

Enviar emails desde un workflow es uno de los casos más útiles de automatización: bienvenidas, confirmaciones, alertas, reportes. n8n te da dos formas de enviar emails: el nodo Gmail (que usa la credencial de Google que ya configuraste en cápsula 03) y el nodo Send Email (que usa SMTP — Simple Mail Transfer Protocol).

¿Cuándo usar cuál?

Gmail node: cuando envías como tú mismo desde Gmail. Aparece como enviado por tu cuenta. Fácil pero está ligado a tu identidad de Google.
Send Email + SMTP: cuando quieres enviar desde un servidor de correo cualquiera — Gmail, tu hosting, SendGrid, Mailgun, un Postfix interno, etc. Más flexible, permite cambiar el "From" sin restricciones de Google.

Esta cápsula te enseña SMTP por dos razones: (1) Gmail ya lo tienes resuelto, (2) SMTP es lo que vas a usar cuando construyas algo serio — envíos masivos, dominio propio, integración con servicios transaccionales como SendGrid o Resend.

Vas a configurar SMTP con Gmail (porque es lo más accesible para empezar), pero el patrón aplica a cualquier proveedor.

Lo que vas a aprender

Al terminar esta cápsula serás capaz de:

✅ Entender qué es SMTP sin jerga técnica
✅ Crear un App Password en Google para usar SMTP con Gmail
✅ Configurar la credencial SMTP en n8n con los 5 valores correctos
✅ Enviar un email real desde un workflow
✅ Adaptar el patrón a otros proveedores (SendGrid, Resend, tu hosting)
✅ Distinguir Gmail node de Send Email + SMTP y elegir el correcto

Modelo mental: el cartero del workflow

Antes de tocar nada, fija esta imagen:

SMTP es el "cartero" del email. Tu workflow le entrega una carta (asunto, destinatario, cuerpo) al cartero, y este se encarga de llevarla. El cartero es un servidor SMTP — puede ser de Google (smtp.gmail.com), de tu hosting (mail.your-domain.com), o un servicio dedicado (smtp.sendgrid.net).

Para que el cartero acepte tu carta, necesitas identificarte: le dices "soy el usuario X con contraseña Y, y tengo derecho a enviar desde esta dirección". Esos 4 datos (host, puerto, usuario, contraseña) son la credencial SMTP.

A diferencia de OAuth, en SMTP no hay pantallas de autorización ni redirects — es protocolo viejo, directo, y funciona en cualquier proveedor del mundo.

Los 5 valores de toda credencial SMTP

Toda credencial SMTP tiene estos campos. Los nombres pueden variar levemente entre proveedores:

Campo	Qué es	Ejemplo Gmail
Host	El servidor SMTP	`smtp.gmail.com`
Port	El puerto de conexión	`465` (SSL) o `587` (STARTTLS)
User	Usuario para autenticarse	`youremail@gmail.com`
Password	Contraseña (o app password)	`abcd efgh ijkl mnop`
SSL/TLS	Cifrado	`SSL` para 465, `STARTTLS` para 587

Cada proveedor publica sus 5 valores en su documentación. Para Gmail, los tienes arriba. Para otros:

SendGrid: host smtp.sendgrid.net, port 587, user apikey, password = tu API key, STARTTLS
Resend: host smtp.resend.com, port 465, user resend, password = tu API key, SSL
Mailgun: host smtp.mailgun.org, port 587, user/password de mailgun, STARTTLS
Tu hosting: consulta el panel (cPanel suele tener una sección "Email accounts" con los datos)

Paso A: Crear un App Password en Google

Por qué App Password y no tu contraseña normal de Gmail: desde 2022, Google no permite usar tu contraseña normal para SMTP (excepto con OAuth). Necesitas un "App Password" — una contraseña dedicada solo para apps, que puedes revocar sin afectar tu cuenta.

A.1. Activar 2-Step Verification (si no la tienes)

App Passwords solo están disponibles si tienes verificación en 2 pasos activada:

Abre: https://myaccount.google.com/security
Sección Signing in to Google → click 2-Step Verification
Si está OFF, actívalo. Sigue los pasos (te pide número de teléfono).

Si tu cuenta es Workspace de empresa y tu admin desactivó 2FA opcional, no vas a poder crear App Passwords. Habla con admin o usa otra cuenta.

A.2. Generar App Password

Abre: https://myaccount.google.com/apppasswords
Inicia sesión otra vez si Google lo pide
Si no tienes ninguno aún, vas a ver Select app y Select device. En interfaces más nuevas, solo aparece App name:
- App name: escribe n8n SMTP
Click Create
Google te muestra una password de 16 caracteres en grupos de 4: abcd efgh ijkl mnop
Cópiala ahora. No vas a poder verla de nuevo (puedes generar otra, pero esta específica desaparece al cerrar).

Esta password bypasea 2FA para SMTP. Cuídala como contraseña real. Si se filtra, ve a https://myaccount.google.com/apppasswords y revoca esa específica — el resto de tu cuenta queda intacta.

Paso B: Configurar la credencial en n8n

B.1. Crear credencial

n8n: Credentials → Add credential → busca SMTP → elige SMTP (es el tipo que usa el nodo Send Email).

B.2. Llenar los campos

User: youremail@gmail.com
Password: la app password de 16 caracteres (con espacios o sin espacios funcionan los dos, Google los ignora)
Host: smtp.gmail.com
Port: 465
SSL/TLS: SSL (toggle activado)

B.3. Nombrar y guardar

Name: Gmail SMTP Mike Personal (o tu contexto)
Click Save

n8n testea la conexión al guardar. Si todo va bien: Connection successful ✓.

Si falla, revisa la sección de Trampas más abajo (el error #1 — "username and password not accepted" — es el más común).

Paso C: Enviar tu primer email

C.1. Crear workflow de prueba

Workflow nuevo [TUTORIAL-M05] Test credencial SMTP
Manual Trigger
Send Email node después
Credential: elige Gmail SMTP Mike Personal
From Email: youremail@gmail.com (debe coincidir con el user de la credencial, o ser un alias válido)
To Email: otro correo tuyo (para no spammear a otros mientras pruebas)
Subject: Test desde n8n
Email Format: Text (más simple para empezar)
Text: Hola, este email salió de un workflow de n8n. 🎉

C.2. Ejecutar

Click Execute step.

Si todo está bien:

Output del nodo: { "messageId": "<...@gmail.com>", "envelope": { ... }, "accepted": [...] }
En tu inbox del destinatario, recibes el email en pocos segundos

¡Funciona!

Paso D: Variantes útiles

Email con HTML (formato richer)

Cambia Email Format a HTML:

<h2>Bienvenido 👋</h2>
<p>Hola {{ $json.name }},</p>
<p>Gracias por registrarte. Tu plan: <strong>{{ $json.plan }}</strong></p>
<p>Saludos,<br>Equipo Nieva</p>

Las expressions {{ $json.name }} se reemplazan con datos del nodo anterior — útil cuando envías a partir de un Sheet o webhook.

Email con adjuntos

En el nodo Send Email, activa Attachments y elige el campo binario (típicamente data) que viene de un nodo anterior (HTTP Request, Read Binary File, etc.).

Email a múltiples destinatarios

En To Email, separa con coma: a@x.com,b@y.com. También funciona en BCC.

Cambiar el "From" a un alias

Si tienes alias configurados en Gmail (enviar como otra dirección), puedes poner el alias en From Email mientras tu user SMTP siga siendo la cuenta principal. Útil para enviar desde support@your-domain.com con un Gmail normal.

Otros proveedores SMTP (tabla de referencia)

Cuando vayas más allá de Gmail (límites de envío, deliverability, dominio propio), vas a usar otros:

Proveedor	Host	Port	User	Password	Mejor para
Gmail	`smtp.gmail.com`	465 (SSL)	tu email	app password	Personal, pruebas, <100 emails/día
SendGrid	`smtp.sendgrid.net`	587 (STARTTLS)	`apikey` (literal)	tu API key	Transaccional volumen alto
Resend	`smtp.resend.com`	465 (SSL)	`resend` (literal)	tu API key	Transaccional moderno, DX excelente
Mailgun	`smtp.mailgun.org`	587 (STARTTLS)	tu usuario	tu password	Transaccional + flexibilidad
Postmark	`smtp.postmarkapp.com`	587 (STARTTLS)	tu server token	mismo token	Transaccional con buena deliverability
Amazon SES	`email-smtp.us-east-1.amazonaws.com`	587 (STARTTLS)	usuario SMTP de SES	password de SES	Volumen industrial barato
Tu hosting (cPanel)	`mail.your-domain.com`	465/587	`user@your-domain.com`	password de la cuenta	Dominio propio sin servicio dedicado

Para producción real, Gmail SMTP tiene límite de 500 emails/día (Gmail personal) o 2,000/día (Workspace). Si vas a mandar más, usa SendGrid, Resend, Postmark o SES. La configuración en n8n es idéntica — solo cambian los 5 valores.

Trampas y errores comunes

Error 1: `535-5.7.8 Username and Password not accepted`

Qué pasa: Save falla con un error mencionando "Username and Password not accepted".

Por qué se da (orden de probabilidad):

Estás usando tu contraseña normal de Gmail, no un App Password. Google bloquea esto.
No tienes 2-Step Verification activada — sin ella, no puedes crear App Passwords.
Copiaste el App Password con un error.
Tu cuenta de Workspace tiene "Less secure apps" bloqueado por política del admin.

Cómo corregir:

Verifica que tu password tiene 16 caracteres (en grupos de 4)
Si no, ve a https://myaccount.google.com/apppasswords, regenera, copia con cuidado
Si la cuenta es Workspace y persiste, contacta al admin

Error 2: `Connection timeout` o `ETIMEDOUT`

Qué pasa: n8n no logra conectarse al host SMTP.

Por qué se da:

Host equivocado (typo: smpt.gmail.com en vez de smtp.gmail.com)
Puerto bloqueado por tu red (algunos ISPs bloquean 465 y 587 por spam)
Firewall del servidor donde corre n8n self-hosted

Cómo corregir:

Verifica host y puerto carácter por carácter
Si self-hosteas en una VM con firewall, abre el puerto 465 saliente
Si tu ISP bloquea, prueba el otro puerto (cambiar 465↔587 y ajustar SSL/TLS)

Error 3: Email enviado pero no llega

Qué pasa: El workflow termina con success, pero el destinatario no recibe el email.

Por qué se da:

Fue a spam. Especialmente con Gmail SMTP enviando a destinos masivos, los receptores lo marcan automáticamente.
From Email no coincide con tu cuenta. Algunos servidores rechazan emails donde el From no matchea el user autenticado.
Rate limit silencioso. Gmail puede aceptar el email pero no entregarlo si superas el límite diario.

Cómo corregir:

Revisa la carpeta de spam del destinatario
Asegúrate de que From Email = User de la credencial (o un alias válido)
Para producción, usa SendGrid/Resend/Postmark con dominio verificado SPF/DKIM/DMARC

Error 4: Funciona en Test pero falla en producción

Qué pasa: El nodo funciona cuando ejecutas el workflow desde el editor, pero el workflow activo falla.

Por qué se da: En self-hosting, a veces el container de n8n no tiene acceso de red a internet para SMTP saliente, mientras que tu máquina de desarrollo sí.

Cómo corregir:

Verifica que el servidor donde corre n8n puede hacer salida al puerto 465/587
Para n8n Cloud, esto no aplica — la red ya está abierta

Error 5: Pegaste mal el espacio en el App Password

Qué pasa: Save falla aunque copiaste 16 caracteres.

Por qué se da: Google muestra el App Password con espacios cada 4 caracteres por legibilidad (abcd efgh ijkl mnop). Algunos clientes son sensibles a los espacios, otros no.

Cómo corregir:

Prueba sin espacios: abcdefghijklmnop
Si sigue fallando, regenera otro App Password y copia cuidadosamente

Ejercicio: email personalizado a partir de un Sheet

Objetivo: combinar credenciales Google + SMTP en un workflow real.

Tu tarea

En tu Sheet n8n-test (de cápsula 03), agrega una columna Email con tu propio email en una fila.
Workflow:
- Manual Trigger
- Google Sheets Get Row(s) (credencial Google) → lee el Sheet
- Send Email (credencial SMTP):
 - To Email: {{ $json.Email }}
 - Subject: Hola {{ $json.Name }} 👋
 - Email Format: HTML
 - HTML:
```
Hola {{ $json.Name }},
Te escribo desde n8n. Sé que vives en {{ $json.City }}.
```
Ejecuta
Revisa tu inbox — debes recibir el email personalizado

Lo que aprendiste con esto

Credenciales son independientes pero se combinan libremente en un workflow
Expressions {{ $json.campo }} pasan datos del Sheet al email
Mismo patrón te sirve para: confirmaciones de compra, bienvenidas, notificaciones internas

Resumen y siguiente paso

SMTP es el protocolo estándar para enviar emails. Cualquier proveedor (Gmail, SendGrid, Resend, tu hosting) usa el mismo patrón en n8n.
Para Gmail SMTP necesitas 2-Step Verification + App Password — Google no acepta tu contraseña normal desde 2022.
5 valores que toda credencial SMTP requiere: host, port, user, password, SSL/TLS
Send Email node (SMTP) vs Gmail node (OAuth) — ambos envían emails; usa Gmail node para enviar como tú, Send Email + SMTP para flexibilidad de servidor.
Para producción: Gmail SMTP tiene límites bajos (500-2000/día). Usa SendGrid, Resend, Postmark o SES.
5 errores comunes: password no aceptada (App Password mal), timeout (host/puerto/firewall), no llega (spam), funciona en test/falla en prod (red), espacios mal copiados

Antes de avanzar deberías poder:

Tener una credencial Gmail SMTP [Tu Nombre] guardada en n8n
Haber enviado al menos un email desde un workflow
Saber qué cambiar para usar SendGrid o Resend en vez de Gmail
Saber qué hacer si el email no llega

Lo que sigue (cápsula 06):

Ya tienes 3 credenciales configuradas (Google, Slack, SMTP). Antes de saltar a workflows reales en producción, hay una conversación importante: seguridad básica. Qué no compartir, rotación, scopes mínimos, y qué hacer si una credencial se filtra accidentalmente. 10 minutos que pueden salvarte de problemas serios.

Recursos adicionales

n8n Send Email Node - Referencia oficial.
Google App Passwords - Documentación oficial de App Passwords.
SMTP Settings Cheatsheet - Lista de proveedores comunes y sus settings.
Email Deliverability Basics - SPF, DKIM, DMARC para que tus emails no vayan a spam.

Creado: Mayo 11, 2026 Versión: 1.0

← AnteriorConfigurar Credenciales de Slack Siguiente →Seguridad Básica de Credenciales

Configurar Credenciales de Email (SMTP)

Descripción de la cápsula

Lo que vas a aprender

Modelo mental: el cartero del workflow

Los 5 valores de toda credencial SMTP

Paso A: Crear un App Password en Google

A.1. Activar 2-Step Verification (si no la tienes)

A.2. Generar App Password

Paso B: Configurar la credencial en n8n

B.1. Crear credencial

B.2. Llenar los campos

B.3. Nombrar y guardar

Paso C: Enviar tu primer email

C.1. Crear workflow de prueba

C.2. Ejecutar

Paso D: Variantes útiles

Email con HTML (formato richer)

Email con adjuntos

Email a múltiples destinatarios

Cambiar el "From" a un alias

Otros proveedores SMTP (tabla de referencia)

Trampas y errores comunes

Error 1: 535-5.7.8 Username and Password not accepted

Error 2: Connection timeout o ETIMEDOUT

Error 3: Email enviado pero no llega

Error 4: Funciona en Test pero falla en producción

Error 5: Pegaste mal el espacio en el App Password

Ejercicio: email personalizado a partir de un Sheet

Tu tarea

Lo que aprendiste con esto

Resumen y siguiente paso

Recursos adicionales

Error 1: `535-5.7.8 Username and Password not accepted`

Error 2: `Connection timeout` o `ETIMEDOUT`