DocumentacionSMTP propio

SMTP propio

Envia a traves de tu propio servidor SMTP (por ejemplo Gmail) por proyecto.

Cada proyecto puede enviar a traves de tu propio servidor SMTP en lugar del transporte compartido — util para el buzon Gmail/Workspace de un cliente o un relay existente. Cuando un proyecto tiene SMTP configurado, sus envios salen por ahi: tiene prioridad y no cae de vuelta al transporte compartido.

Configurar

Pon los campos SMTP en un proyecto por la API (scope projects:write) o desde el panel:

PATCH /projects/{projectId}
Authorization: Bearer <apiKey o accessToken>
X-Tenant-Id: {tenantId}
Content-Type: application/json

{
  "fromEmail": "[email protected]",
  "fromName": "Tu Marca",
  "smtpHost": "smtp.gmail.com",
  "smtpPort": 465,
  "smtpSecure": true,
  "replyTo": "[email protected]"
}

Envia tu smtpUser y smtpPassword en el mismo body — ambos estan documentados en la tabla de abajo.

CampoNotas
smtpHost / smtpPortTu servidor. Puerto 465 + smtpSecure: true, o 587 + smtpSecure: false
smtpUser / smtpPasswordCredenciales. La contrasena se cifra en reposo (AES-256-GCM) y nunca se devuelve
smtpSecureTLS en la conexion. Por defecto true
fromEmail / fromName / replyToIdentidad de remitente de este proyecto

La contrasena es de solo escritura: las lecturas devuelven smtpConfigured: true/false en vez del valor. Envia "smtpPassword": "" para borrarla y volver al transporte compartido.

Verificar las credenciales

POST /projects/{projectId}/verify-smtp

Hace un handshake de login en vivo contra tu servidor SMTP y devuelve error si falla — la forma mas rapida de confirmar que una app password de Gmail funciona.

Gmail

Usa una app password de Gmail (no tu contrasena de cuenta) y fija host y puerto de forma explicita:

  • smtp.gmail.com, puerto 465, smtpSecure: true, o
  • smtp.gmail.com, puerto 587, smtpSecure: false.

Como se elige el transporte al enviar

Cuando envias con un projectId que tiene SMTP configurado, el mensaje sale por ese servidor SMTP (provider: smtp). Si no, MailingCore usa su transporte compartido y autenticado. Ver Enviar email.