API de envío de correo electrónico: Gmail, Outlook e IMAP desde cuentas de usuario (2026)

Índice
Índice 8 secciones
Cimientos
Proveedores
Integración
Referencia
API de Correo Electrónico de Cuentas de Usuario

API de envío de correo electrónico: Enviar desde el usuario Gmail, Outlook y IMAP Cuentas

La mayoría de las API de correo electrónico envían desde un dominio compartido que posees. La API de envío de correo electrónico de Unipile es diferente: envía desde las cuentas de Gmail, Outlook e IMAP de tus usuarios, con OAuth2 completo, sin almacenamiento de credenciales y un único punto final unificado para cada proveedor. Cuando tu SaaS necesita enviar correo electrónico mediante programación en nombre de personas reales, esta es la integración que lo hace funcionar.

Conexión OAuth2, sin almacenamiento de contraseñas
Un punto final unificado, todos los proveedores
Gmail, Outlook y IMAP compatibles
Infraestructura conforme a SOC2
GmailGmail
OutlookOutlook
IMAPIMAP
Comenzar a construir Ver documentos
API de envío de correo electrónico - cuentas de usuario
Enviado desde cuentas vinculadas
Gmail
sarah@acme.com (Gmail)
Dando seguimiento a nuestra conversación
Enviado
Outlook
mark@corp.io (Outlook)
Resumen de tu incorporación
Enviado
IMAP
lisa@startup.co (IMAP)
Bienvenido a la plataforma
Enviado
POST /api/v1/emails
"account_id": "acc_gmail_xyz",
"a": [{ "identificador": "sarah@acme.com" }],
"Asunto": "Haciendo seguimiento..."
200 OK - correo en cola
¿Qué es una API de envío de correo electrónico con cuenta de usuario?

Una API para enviar correos electrónicos que actúa en nombre de sus usuarios

La mayoría de las búsquedas de "API para enviar correos electrónicos" conducen a proveedores transaccionales. Este no es el caso. Unipile es una API de correo electrónico de cuentas de usuario: se conecta a las cuentas reales de Gmail u Outlook de sus usuarios y envía en su nombre, con su identidad y su capacidad de entrega.

Casos clave

Por qué los desarrolladores crean aplicaciones con una API de correo electrónico de cuenta de usuario

Cuando su producto necesita enviar correos electrónicos programáticamente desde personas reales (no una dirección noreply@), estos son los escenarios que impulsan la adopción.

CRM y Automatización de Ventas

Envía correos electrónicos de seguimiento desde la cuenta de Gmail u Outlook de cada vendedor. Tasas de respuesta más altas, identidad de remitente auténtica, no se requiere calentamiento de dominio. Los prospectos ven un nombre real, no un alias genérico.

Plataformas de atención al cliente

Permita que los agentes de soporte respondan directamente desde su propio buzón de correo. Los clientes ven el nombre y la dirección de correo electrónico de una persona real, no un alias de soporte@. Crea confianza, aumenta la velocidad de resolución.

ATS y Herramientas de Reclutamiento

Llega a los candidatos con correos electrónicos personalizados desde la cuenta real del reclutador. Sin dominios fríos, sin riesgo de filtro de spam, sin período de calentamiento. El correo electrónico llega a la bandeja de entrada como un mensaje personal, porque lo es.

Proveedores compatibles

Enviar correo electrónico desde Gmail, Outlook e IMAP: Una API

La API de envío de correo de Unipile abstrae completamente la capa del proveedor. Ya sea que la cuenta de su usuario sea Gmail, Outlook, Microsoft 365, Exchange Online o cualquier buzón compatible con IMAP, la llamada a la API es idéntica. Usted escribe la integración una vez y cada proveedor simplemente funciona.

Gmail
Google Workspace incluido
Autenticación OAuth2, no se requiere contraseña
Ámbito: gmail.enviarhuella mínima de permisos
Hasta 500 correos electrónicos/día por cuenta personal, límites más altos para Workspace
Excelente entregabilidad: infraestructura de Google, reputación del usuario
OAuth2 listo
Outlook
Cubre Microsoft 365 y Exchange Online
OAuth2 a través de Microsoft Identity Platform
Permiso: Mail.Enviardelegado o a nivel de aplicación
Funciona para cuentas personales de Outlook, Microsoft 365 y Exchange Online
Hasta 10.000 destinatarios/día para cuentas de M365
OAuth2 listo
IMAP
Soporte universal de respaldo para cualquier proveedor
Admite IMAP/SMTP con credenciales u OAuth2 cuando esté disponible
Funciona con Yahoo, Zoho, Fastmail, servidores de correo corporativos personalizados
Mismo endpoint de la API de Unipile, sin trabajo de integración adicional.
Ideal para usuarios B2B con dominios personalizados y correo electrónico corporativo
Universal
Guía paso a paso

Cómo enviar correo electrónico a través de una API: Integración paso a paso

Desde la vinculación de cuentas hasta el envío de su primer correo electrónico mediante programación, aquí tiene el flujo completo. Esta guía cubre Gmail y Outlook; los pasos para IMAP son idénticos, solo el tipo de cuenta varía.

1
Obtén tu clave API de Unipile

Regístrate en el panel de Unipile. Cada espacio de trabajo recibe una clave API. Todas las solicitudes se autentican con la X-API-KEY header. No requiere configuración OAuth de tu parte: Unipile se encarga de la autenticación del proveedor por ti.

rizo
# Verifique su clave de API rizo -X GET https://api.unipile.com/api/v1/accounts \ -H "X-API-KEY: {TU_API_KEY}"
2
Vincular una cuenta de usuario (Gmail, Outlook o IMAP)

Genera un enlace de autenticación alojado a través de la API. El usuario hace clic en él y pasa por la pantalla de consentimiento estándar de OAuth2 para su proveedor. Unipile almacena los tokens de forma segura y devuelve un account_id. Nunca tocas credenciales.

rizo JavaScript Python
# Generar un enlace de autenticación alojado para Gmail rizo -X POST https://api.unipile.com/api/v1/hosted/accounts/link \ -H "X-API-KEY: {TU_API_KEY}" -H "Content-Type: application/json" -d '{"type":"GOOGLE","api_url":"https://api.unipile.com","expiresOn":"2026-12-31T00:00:00.000Z"}'
// Generar enlace de autenticación - Node.js const res = await buscar('https://api.unipile.com/api/v1/hosted/accounts/link', { método: POST, encabezados: { 'X-API-KEY': '{TU_CLAVE_API}', 'Content-Type': aplicación/json}, cuerpo: JSON.stringify({ tipo: 'GOOGLE', url_api: 'https://api.unipile.com', expiraEn: '2026-12-31T00:00:00.000Z'}) });const { url } = await res.json();
# Generar enlace de autenticación - Python import solicitudes res = requests.post( 'https://api.unipile.com/api/v1/hosted/accounts/link', encabezados={'X-API-KEY': '{TU_CLAVE_API}'}, json={ 'tipo': 'GOOGLE', 'api_url': 'https://api.unipile.com', 'expiraEl': '2026-12-31T00:00:00.000Z') url = res.json()['url']
Para Outlook, usa "tipo":"MICROSOFT". Para IMAP, usa "tipo":"IMAP". El mismo flujo alojado maneja a los tres proveedores.
3
Recuperar el account_id de la devolución de llamada del webhook

Después de que el usuario completa OAuth2, Unipile dispara un webhook a tu endpoint con el account_id. Almacénala en tu base de datos: será la clave que usarás en cada llamada a la API de envío de correos para ese usuario.

carga útil JSON
// Ejemplo de carga útil de webhook (evento account.linked){ "evento": "cuenta.vinculada", "account_id": "acc_gmail_Abc123XYZ", "proveedor": "Google", "correo electrónico": "sarah@acme.com"}
4
Enviar correo electrónico desde la cuenta vinculada

PUBLICAR a /api/v1/emails con el account_id. El correo electrónico sale de la bandeja de entrada real de Gmail o Outlook del usuario, igual que si lo hubieran enviado ellos mismos. El punto final es idéntico independientemente de si la cuenta vinculada es Gmail, Outlook o IMAP.

rizo JavaScript Python
# Enviar correo electrónico desde una cuenta de Gmail vinculada rizo -X POST https://api.unipile.com/api/v1/emails \ -H "X-API-KEY: {TU_API_KEY}" -H "Content-Type: application/json" -d '{ "account_id": "{ID_DE_CUENTA}", "para": [{"display_name": "John Doe", "identifier": "john@example.com"}], "Asunto: Dando seguimiento a nuestra conversación, "cuerpo"<p>Hola, John,</p><p>Solo quería hacer seguimiento...</p>" }'
// Enviar correo electrónico - Node.js const res = await buscar('https://api.unipile.com/api/v1/emails', { método: POST, encabezados: { 'X-API-KEY': '{TU_CLAVE_API}', 'Content-Type': aplicación/json}, body: JSON.stringify({ account_id: '{ID_DE_CUENTA}', para: [{ nombre_a_mostrar: 'John Doe', identificador: 'john@example.com' }], asunto: 'Como seguimiento a nuestra conversación', cuerpo: '<p>Hola, John,</p><p>Solo quería hacer seguimiento...</p>'}) });const datos = await res.json();
# Enviar correo electrónico - Python import solicitudes res = requests.post( 'https://api.unipile.com/api/v1/emails', encabezados={'X-API-KEY': '{TU_CLAVE_API}'}, json={ 'id_cuenta': '{ID_DE_CUENTA}', 'a': [{ 'nombre_en_pantalla': 'John Doe', 'identificador': 'john@example.com' }], 'asunto': 'Como seguimiento a nuestra conversación', 'cuerpo': '<p>Hola, John,</p><p>Solo quería hacer seguimiento...</p>'} ) print(res.json())
La respuesta incluye un ID de mensaje y un estado de entrega. También puede añadir "cc", "CCO", "responder_a"y "adjuntos" al mismo payload.

¿Listo para enviar correos electrónicos desde Gmail, Outlook e IMAP?

Tu clave de API está esperando. Empieza a construir en menos de 10 minutos.

Empezar a construir ahora Ver documentos
Punto de conexión de API unificado

Un punto final unificado para enviar correos electrónicos a través de todos los proveedores

La mayor fricción en las integraciones de múltiples proveedores es mantener rutas de código separadas para cada servicio de correo electrónico. Unipile elimina eso. Ya sea que la cuenta vinculada sea Gmail, Outlook o IMAP, siempre llamas al mismo endpoint con la misma carga útil. La capa de abstracción maneja los protocolos específicos del proveedor, las actualizaciones de tokens y las diferencias en los límites de velocidad entre bastidores.

POST /api/v1/emails - idéntico para todos los proveedores Unificado
POST https://api.unipile.com/api/v1/emails X-API-KEY: {TU_API_KEY}{ "account_id": "{ID_DE_CUENTA}", "a": [ "nombre_a_mostrar": "Juan Pérez", "identificador": "john@example.com"}], "Asunto": "Actualización de tu proyecto", "cuerpo": "<p>Hola John...<\/p>""}// Funciona para Gmail, Outlook e IMAP // account_id le dice a Unipile qué cuenta usar
GmailGmail
+
OutlookOutlook
+
IMAPIMAP
/api/v1/emails
Explora la API de correo unificada multi-proveedor
Escribe una vez, soporta a cada proveedor

No hay rutas de código separadas para Gmail vs Outlook. Una integración cubre los tres proveedores hoy y cualquier adición futura que Unipile agregue.

Actualización de token manejada automáticamente

Los tokens de acceso de OAuth2 caducan. Unipile los actualiza de forma transparente. Tu código nunca maneja el ciclo de vida de los tokens; solo llama a la API y envía.

Escala a miles de cuentas vinculadas

Cada usuario vincula su propia cuenta. Usted gestiona un account_id por usuario; Unipile se encarga del resto. Sin malabarismos de SDK por proveedor.

Formato de respuesta consistente

La API devuelve la misma estructura JSON independientemente del proveedor. Analiza un esquema, crea un manejador de errores, envía más rápido.

¿Necesitas enviar correos electrónicos en nombre de tus usuarios a escala? Lee la guía completa sobre cómo enviar correos electrónicos en nombre de sus usuarios, incluido el modelo de cumplimiento y consentimiento que Unipile utiliza para mantener todo auditable.

Referencia API

Todos los puntos de conexión de la API para enviar correos electrónicos, organizados

Todos los puntos de conexión disponibles para conectar cuentas, enviar y responder, administrar tu buzón y escuchar eventos en Gmail, Outlook e IMAP con una única integración.

Explorar todos los puntos finales
Gmail Outlook IMAP
Enviar y responderEnviar
Configuración de cuentaCuenta
Gestionar correos electrónicosGestione
Webhooks

Enviar y responder

4 puntos finales disponibles

GmailGmail
OutlookOutlook
IMAPIMAP
Enviar un correo electrónico
Responder a un correo electrónico
Reenviar un correo electrónico
Enviar con archivos adjuntos

Configuración de cuenta

3 puntos finales disponibles

GmailGmail
OutlookOutlook
IMAPIMAP
Autenticación alojada: flujo OAuth de marca blanca
Usa tu propia pantalla de OAuth
Conectar con credenciales (SMTP)

Gestionar correos electrónicos

5 puntos finales disponibles

GmailGmail
OutlookOutlook
IMAPIMAP
Lista de correos electrónicos
Obtener correo electrónico
Borrar correo electrónico
Mover correo electrónico
Lista de carpetas

Webhooks

2 eventos disponibles

GmailGmail
OutlookOutlook
IMAPIMAP
Nuevo correo recibido
Seguimiento de aperturas y clics
Explorar la referencia API
Guía de la API de correo electrónico
¿Quieres la guía completa de integración de la API de correo electrónico?

Cubre flujos de autenticación, configuración de webhooks, lectura y envío de correos electrónicos, archivos adjuntos y una comparación completa de proveedores, todo lo que necesitas para crear una integración de API de envío de correos electrónicos lista para producción.

Leer la Guía de la API de correo electrónico
Autenticación y Seguridad

Autenticación y seguridad para la integración de tu API de envío de correo electrónico

Manejar las credenciales de correo electrónico de los usuarios es una de las partes de mayor riesgo de cualquier integración SaaS. La arquitectura de Unipile está diseñada para que nunca almacenes ni transmitas tokens OAuth2 directamente; la superficie de riesgo se mantiene mínima y el cumplimiento se mantiene manejable.

OAuth2: sin almacenamiento de credenciales de tu parte

Unipile genera la URL de consentimiento OAuth2, recopila el código de autorización y almacena los tokens de acceso y actualización en su propia bóveda encriptada. Tu backend solo ve un account_id. Sin tokens crudos, sin contraseñas, sin deriva de credenciales.

Renovación automática de tokens

Los tokens de Gmail OAuth2 expiran después de 1 hora. Los tokens de Microsoft expiran después de 1 hora (acceso) o 90 días (actualización). Unipile los actualiza automáticamente antes de que expiren. Tus llamadas a la API de envío de correos nunca fallan debido a un token obsoleto.

Ámbitos mínimos de OAuth2

Para una integración de solo envío, Unipile solicita solo los ámbitos necesarios: gmail.enviar para Gmail y Mail.Enviar para Outlook. Esto sigue el principio de menor privilegio y reduce la superficie de ataque para los datos de sus usuarios.

Verificación de firma de webhook

Cada webhook que Unipile envía a tu endpoint incluye una cabecera de firma que puedes verificar contra tu secreto de webhook. Esto asegura que las cargas útiles de eventos no puedan ser falsificadas por terceros que intenten activar acciones en tu sistema.

SOC 2 Tipo II

La infraestructura de Unipile cuenta con la certificación SOC 2 Tipo II. Los controles auditados cubren la gestión de acceso, el cifrado en reposo y en tránsito, la respuesta a incidentes y la disponibilidad. Esto facilita la superación de las revisiones de seguridad de proveedores cuando sus clientes SaaS le preguntan cómo maneja las credenciales de correo electrónico.

Aprende sobre la API de correo electrónico seguro
CASA Nivel 2

Unipile tiene una evaluación de Nivel 2 de CASA, el estándar de seguridad requerido por Google para aplicaciones que acceden a alcances sensibles de la API de Gmail. La evaluación es realizada por un laboratorio autorizado y cubre el manejo de datos, controles de acceso y prácticas de desarrollo seguro. Es requerido para mantener el acceso de producción a los alcances de envío de Gmail.

Capacidades de la API

Cobertura total de la API de correo electrónico en todos los proveedores

Una integración te da acceso a todas las operaciones principales de correo electrónico a través de proveedores de Gmail, Outlook e IMAP. El mismo endpoint, la misma estructura de carga útil, el mismo formato de respuesta independientemente de la cuenta que tu usuario haya conectado.

Característica Gmail Outlook / M365 IMAP / SMTP
Enviando
Enviar correo electrónico desde la cuenta de usuario
Enviar con archivos adjuntos
Responder en el hilo existente
Destinatarios CC y CCO
Contenido del cuerpo HTML
Imágenes en línea (incrustación CID)
Límite diario de envío (aprox.) ~500 / día ~10.000 / día Dependiente del servidor
Lectura y sincronización
Listar y leer correos electrónicos
Vista de hilo / conversación
Webhooks en tiempo real (correo nuevo, leído, enviado)
Sincronización delta incremental
Gestión de etiquetas y carpetas Etiquetas Carpetas Carpetas
Autenticación y Seguridad
OAuth2 (almacenamiento sin contraseña) Contraseña de aplicación
Renovación automática de tokens
SOC 2 Tipo II / CASA Nivel 2
Errores comunes

Errores comunes al integrar una API de envío de correos electrónicos

La mayoría de los problemas que encuentran los desarrolladores al integrar una API de envío de correos electrónicos de cuentas de usuario entran en un pequeño conjunto de categorías. Estas son las que vale la pena conocer antes de empezar a construir.

01
Ignorando los límites de tarifa del proveedor

Las cuentas personales de Gmail están limitadas a aproximadamente 500 correos electrónicos por día. Las cuentas de Outlook tienen límites más altos pero aún pueden experimentar estrangulamiento en condiciones de ráfaga. Superar estos límites da como resultado errores 429 o la suspensión temporal de la cuenta por parte del proveedor.

Corregir:Realiza un seguimiento de los recuentos de envíos por cuenta vinculada, implementa reintentos exponenciales en las respuestas 429 y distribuye los envíos masivos en ventanas de tiempo en lugar de enviarlos en una sola ráfaga.
02
No se está manejando la revocación de tokens

Los usuarios pueden revocar el acceso en cualquier momento desde la configuración de su cuenta de Google o Microsoft. Cuando esto sucede, Unipile devolverá un error en la próxima llamada a la API para esa cuenta. Si su aplicación no maneja esto correctamente, resultará en fallos silenciosos en la entrega de correos electrónicos.

Corregir:Escucha por el cuenta.desconectada evento de webhook y solicitar al usuario que vuelva a vincular su cuenta.
03
Envío sin consentimiento explícito del usuario

Incluso con un token OAuth2 válido, enviar correos electrónicos desde la cuenta de un usuario sin su conocimiento viola las políticas de uso de Google y Microsoft y las leyes de spam de la mayoría de las jurisdicciones. La pantalla de consentimiento de OAuth2 debe explicar claramente lo que hará su aplicación.

Corregir:Utilice un lenguaje claro en su pantalla de consentimiento OAuth y en las descripciones de la aplicación. Documente qué desencadena un envío automático y otorgue a los usuarios el control para deshabilitarlo.
04
Almacenamiento de tokens OAuth2 sin procesar en su base de datos

Si almacena los tokens de acceso usted mismo y estos se exponen en una filtración de datos, un atacante tiene acceso completo a todas las cuentas de correo electrónico vinculadas. Este es un riesgo crítico de seguridad y cumplimiento, especialmente bajo el RGPD.

Corregir:Utiliza el flujo de autenticación alojado de Unipile. Solo almacenas el account_id; Unipile guarda los tokens en su bóveda certificada SOC 2. Tu base de datos nunca toca un token OAuth2 sin procesar.
05
Tratar SMTP y una API REST de envío de correo electrónico como intercambiables

SMTP requiere acceso directo al servidor, gestión de credenciales, configuración TLS y manejo de rebotes. Una API REST para enviar correos abstrae todo eso. Combinar ambos enfoques en la misma base de código agrega complejidad sin beneficio.

Corregir:Para el envío de cuentas de usuario, utilice exclusivamente la API REST. SMTP solo es relevante si usted opera su propia infraestructura de correo o tiene un proveedor que no admite OAuth2.

Preguntas frecuentes

Todo lo que necesitas saber sobre la API para enviar correos electrónicos.

Una API para enviar correos electrónicos es una interfaz REST que permite que tu aplicación envíe correos electrónicos de forma programática sin abrir un cliente de correo electrónico. La API para enviar correos electrónicos de Unipile envía específicamente desde cuentas propiedad del usuario (Gmail, Outlook, IMAP), lo que significa que el correo electrónico llega desde la dirección real del usuario en lugar de un dominio genérico noreply@ que tú controlas.
Con Unipile, generas un enlace de autenticación alojado para el tipo de proveedor GOOGLE. El usuario se autentica a través de la pantalla de consentimiento OAuth2 estándar de Google. Una vez enlazado, recibes un account_id vía webhook. Luego haces POST a /api/v1/emails con ese account_id y el payload de tu mensaje. El correo se envía desde su dirección real de Gmail. No se requiere configuración de clave de API de Gmail de tu parte.
Sí. Unipile permite enviar correos electrónicos de forma programática desde cuentas de Outlook, incluidas cuentas personales de Outlook, Microsoft 365 y Exchange Online, todo a través del mismo punto final de la API. Vinculas la cuenta utilizando el tipo de proveedor MICROSOFT. La autenticación utiliza OAuth2 con el Mail.Enviar permiso delegado. Unipile maneja el refresco de tokens automáticamente.
Para una integración de solo envío, el ámbito mínimo requerido es https://www.googleapis.com/auth/gmail.send. Esto permite enviar correos electrónicos pero no otorga acceso para leer, modificar o eliminar mensajes. Al usar Unipile, no configuras este alcance tú mismo; el flujo de autenticación alojado se encarga de ello. Para un caso de uso de API de envío de correo electrónico puro, gmail.enviar es suficiente.
Estos son mercados diferentes para problemas diferentes. Las API transaccionales envían desde un dominio que usted posee y controla. Unipile no está en ese mercado. Unipile se conecta a las cuentas reales de Gmail u Outlook de sus usuarios y envía en su nombre, con su identidad, para casos de uso donde la dirección del remitente importa: secuencias de CRM, respuestas de soporte, alcance.
Los límites de tasa se aplican a nivel del proveedor, no a nivel de Unipile. Las cuentas personales de Gmail permiten aproximadamente 500 correos electrónicos por día. Las cuentas de Outlook y Microsoft 365 tienen límites más altos, pero pueden experimentar estrangulamiento bajo ráfagas intensas. Mejor práctica: rastrear el volumen de envío por cuenta vinculada en su propia base de datos, implementar retroceso exponencial cuando reciba respuestas 429 y distribuir los envíos masivos en ventanas de tiempo. Unipile devuelve el código de error del proveedor para que pueda distinguir un error de límite de tasa de un error de autenticación.
Sí: eso es exactamente lo que Unipile proporciona. Una POST /api/v1/correos el endpoint maneja cuentas de Gmail, Outlook y IMAP. El proveedor se determina por el account_id en la carga útil; no es necesario especificarlo. Escriba su lógica de envío una vez y funcionará independientemente del proveedor de correo electrónico que su usuario haya vinculado.
Unipile utiliza exclusivamente OAuth2; no se almacenan contraseñas. Los usuarios pasan por la pantalla de consentimiento estándar del proveedor y pueden revocar el acceso en cualquier momento desde la configuración de su cuenta de Google o Microsoft. Unipile tiene certificación SOC 2 Tipo II, lo que significa que los controles de seguridad, incluida la gestión de acceso, el cifrado y la respuesta a incidentes, son auditados de forma independiente. Los tokens OAuth2 se almacenan en una bóveda cifrada y nunca se exponen a su aplicación.

¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.

Empezar a construir hoy
Tu API de envío de correos, lista en minutos

Conecta tu primera cuenta de Gmail, Outlook o IMAP y envía tu primer correo electrónico de forma programática en menos de 30 minutos. Sin almacenamiento de credenciales, sin configuración de OAuth2 de tu lado, sin SDK por proveedor. Un account_id, un endpoint REST, todos los proveedores.

Empezar prueba gratis Leer la documentación del desarrollador
Certificación SOC 2 Tipo II
No se necesita tarjeta de crédito
Gmail, Outlook y IMAP compatibles
es_ESES