Registra una o más solicitudes de envío de correo electrónico.
Contenido
Debe proporcionarse exactamente uno entre templateId y html.
- Con
templateId, el asunto proviene de la plantilla almacenada y cualquiersubjectenviado se ignora. Consulte las plantillas disponibles enGET /email/v1/templates. - Con
html,subjectes obligatorio.
Tanto el asunto como el cuerpo admiten variables con la sintaxis {{variable}}, que se sustituyen con los valores de fields de cada destinatario.
Remitente
from es obligatorio y debe pertenecer a un dominio remitente verificado para la cuenta.
Adjuntos
Los archivos se envían en base64 dentro del array attachments, en la misma solicitud.
- Para que todos los destinatarios reciban los mismos archivos, declare
attachmentsen la raíz. - Para enviar archivos distintos a cada destinatario, declare
attachmentsdentro de cada elemento depayload.
No mezcle los dos modos. Se admiten hasta 10 archivos que sumen 8 MB, y el cuerpo completo de la solicitud no puede superar 20 MB.
Los campos attachmentId y attachmentName, tanto en la raíz como dentro del destinatario, pertenecen al flujo heredado que exige cargar el archivo antes con POST /email/v1/attachments. Utilice attachments en su lugar.
Respuesta
El servicio retorna 202 incluso cuando la solicitud o algunos destinatarios fallan validación. Revise siempre overallStatus, errors y el estado individual de cada elemento de recipients.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401API key ausente o no válida.
403La API key es válida pero no tiene permiso para enviar correo.
413El cuerpo de la solicitud supera los 20 MB. Envíe menos destinatarios o menos adjuntos por llamada.
