Módulo 2: Gmail y Email

Conectar Gmail a n8n

Descripción de la cápsula

Conectar Gmail es casi lo mismo que conectaste Google Sheets en el Módulo 1 — el mismo Google, el mismo OAuth2, el mismo flujo de "Sign in with Google". Pero hay una diferencia importante: los permisos (scopes) que pides son distintos, y los de Gmail son más sensibles.

Cuando autorizas Sheets, le das a n8n acceso a tus hojas de cálculo. Cuando autorizas Gmail, le das acceso a leer, enviar y borrar tus correos. Es un permiso más delicado, y Google a veces lo trata con más fricción (pantallas de advertencia adicionales). Esta cápsula te lleva por ese flujo sin sorpresas.

El objetivo es terminar con una credencial de Gmail funcionando y un nodo que envía un correo de prueba. Corto y directo — todo lo demás del módulo se construye encima.

Lo que vas a aprender

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

✅ Crear una credencial de Gmail en n8n con OAuth2
✅ Entender los permisos de Gmail y por qué son más sensibles que los de Sheets
✅ Pasar las pantallas de advertencia de Google sin atascarte
✅ Agregar el nodo Gmail y enviar un correo de prueba
✅ Distinguir el nodo Gmail del Gmail Trigger (y cuándo usar cada uno)
✅ Decidir entre OAuth2 y Service Account para Gmail

El nodo Gmail vs el Gmail Trigger

Antes de la credencial, una distinción que confunde a todos al inicio. n8n tiene dos cosas relacionadas con Gmail:

Componente	Qué hace	Va...
Gmail (nodo de acción)	Envía, lee, etiqueta, busca correos	En medio o al final del workflow
Gmail Trigger	Dispara un workflow cuando llega un correo	Al inicio del workflow

Ambos usan la misma credencial. La credencial que creas en esta cápsula sirve para los dos. El nodo Gmail lo usamos desde la cápsula 03; el Gmail Trigger desde la 04.

Los dos tipos de credencial

Igual que con Sheets:

Tipo	Cuándo usarla	Dificultad
OAuth2	Tu cuenta personal o de trabajo. Caso normal.	Baja
Service Account	Cuentas de servidor, Google Workspace con delegación de dominio.	Alta

Para este módulo, usa OAuth2. Service Account con Gmail solo tiene sentido en Google Workspace empresarial con configuración de delegación — territorio de G10.

Paso a paso: crear la credencial

Paso A: Abrir el gestor de credenciales

En n8n → Credentials → Add credential
Busca Gmail
Selecciona Gmail OAuth2 API

Paso B: Conectar con Google

n8n Cloud: el botón Sign in with Google funciona directo
n8n self-hosted: necesitas un proyecto en Google Cloud Console con Client ID y Client Secret (setup de una vez; n8n muestra las instrucciones)

Si ya configuraste Google Cloud Console para Sheets en el Módulo 1, puedes reusar el mismo proyecto — solo necesitas habilitar la Gmail API en ese proyecto. No tienes que empezar de cero.

Paso C: Aceptar los permisos

Aquí Gmail se diferencia de Sheets. Google te mostrará permisos como:

Leer, redactar, enviar y eliminar permanentemente todo tu correo de Gmail

Es un permiso amplio. Si tu proyecto de Google Cloud está en modo "Testing" (lo normal al empezar), puede que veas una pantalla que dice "Google no ha verificado esta aplicación". No es un error:

Click en Configuración avanzada (o "Advanced")
Click en Ir a [tu proyecto] (no seguro)
Acepta los permisos

Esa advertencia aparece porque tu propio proyecto de Google Cloud no está "verificado" por Google — lo cual es totalmente normal para uso personal. Estás autorizando tu propia app a acceder a tu propia cuenta.

Paso D: Nombrar la credencial

Nómbrala claro: Gmail - cuenta negocio o Gmail - personal. Vas a tener varias credenciales de Google; los nombres descriptivos te salvan.

Paso a paso: enviar un correo de prueba

Confirmamos que la credencial sirve.

Paso 1: Construir el workflow

Workflow nuevo → agrega un Manual Trigger
Agrega un nodo Gmail
En Credential, elige la que acabas de crear

Paso 2: Configurar el envío

Resource: Message
Operation: Send
To: tu propia dirección (o una segunda cuenta de prueba)
Subject: Prueba desde n8n
Email Type: Text (lo más simple para la prueba)
Message: Si lees esto, la credencial de Gmail funciona.

Paso 3: Ejecutar

Click en Test step. Revisa la bandeja del destinatario. Si llegó el correo: la conexión funciona.

Si tarda un par de minutos o cayó en spam, no te preocupes todavía — eso es la naturaleza del email (cápsula 07 lo cubre). Lo importante ahora: el correo salió.

Qué acabas de autorizar (y cómo revocarlo)

Le diste a n8n permiso para actuar sobre toda tu cuenta de Gmail. Es poder real. Conviene saber cómo verlo y cortarlo:

Ve a myaccount.google.com/permissions
Ahí aparece tu app de n8n con los permisos que tiene
Desde ahí puedes revocar el acceso en cualquier momento

Revocar el acceso no borra tus workflows en n8n — solo invalida la credencial. Tendrías que reconectarla para que vuelvan a funcionar.

Buena práctica: si vas a automatizar correo de forma seria para un negocio, considera una cuenta de Gmail dedicada a las automatizaciones (automations@yourdomain.com), separada de tu correo personal. Así el acceso de n8n está acotado a una cuenta cuyo único propósito es ese.

Trampas comunes

Trampa 1: Atascarse en la pantalla "Google no ha verificado esta aplicación"

Qué pasa: Ves la advertencia y crees que algo está mal, así que no continúas.

Cómo evitar: Es normal para proyectos personales en modo Testing. Click en Configuración avanzada → Ir a [proyecto]. Estás autorizando tu propia app.

Trampa 2: No habilitar la Gmail API en Google Cloud

Qué pasa: En self-hosted, la credencial parece conectar pero todo nodo de Gmail falla con un error de API.

Cómo evitar: En Google Cloud Console, además de crear las credenciales OAuth, hay que habilitar la Gmail API explícitamente para ese proyecto. Es un toggle aparte.

Trampa 3: Confundir el nodo Gmail con el Gmail Trigger

Qué pasa: Quieres que un correo entrante dispare el workflow y agregas el nodo Gmail — pero el nodo Gmail no dispara nada, solo ejecuta acciones.

Cómo evitar: Para disparar desde un correo, necesitas el Gmail Trigger (cápsula 04). El nodo Gmail es para hacer cosas (enviar, leer, etiquetar).

Trampa 4: Usar la credencial de Sheets para Gmail

Qué pasa: Tienes una credencial de Google Sheets y esperas que sirva para Gmail.

Cómo evitar: Aunque ambas son "de Google", cada una tiene scopes distintos. La credencial de Sheets no tiene permiso de Gmail. Necesitas una credencial Gmail OAuth2 API propia.

Ejercicio: conecta y envía

Objetivo: terminar con una credencial de Gmail y un envío funcionando.

Tu tarea

Crea la credencial Gmail OAuth2 API en n8n
Si estás en self-hosted, confirma que la Gmail API esté habilitada en Google Cloud
Construye un workflow: Manual Trigger → Gmail (Send)
Envíate un correo de prueba a ti mismo
Confírma que llegó (revisa también spam)

Checklist de éxito:

La credencial muestra estado conectado
El nodo Gmail acepta la credencial sin error
El correo de prueba llega a la bandeja
Sabes dónde revocar el acceso si lo necesitas

Resumen y siguiente paso

Conectar Gmail es el mismo flujo OAuth2 que Sheets, pero con permisos más sensibles (leer/enviar/borrar correo)
La advertencia "Google no ha verificado esta aplicación" es normal para proyectos personales — Configuración avanzada → continuar
El nodo Gmail ejecuta acciones (enviar, leer, etiquetar); el Gmail Trigger dispara workflows — misma credencial, usos distintos
En self-hosted hay que habilitar la Gmail API en Google Cloud, no solo crear credenciales
Buena práctica: una cuenta dedicada a automatizaciones, separada del correo personal
4 trampas: atascarse en la advertencia, no habilitar la API, confundir nodo con trigger, reusar la credencial de Sheets

Antes de avanzar deberías poder:

Crear una credencial de Gmail sin ayuda
Enviar un correo de prueba
Explicar la diferencia entre el nodo Gmail y el Gmail Trigger

Lo que sigue (cápsula 03):

Ya conectado, profundizamos en la primera dirección: enviar correos. Vas más allá del texto plano: correos con formato HTML, varios destinatarios (To, CC, BCC), archivos adjuntos, y cómo componer el cuerpo del correo con datos de nodos anteriores.

Recursos adicionales

n8n Gmail Credentials Docs - Setup de credenciales de Google.
Google Account permissions - Ver y revocar el acceso de n8n.
Google Cloud Console - Donde se habilita la Gmail API (solo self-hosted).

Creado: Mayo 14, 2026 Versión: 1.0

← AnteriorIntroducción al Módulo: Gmail y Email Siguiente →Enviar Correos