Enviar correos electrónicos

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 cualquier subject enviado se ignora. Con html, subject es obligatorio.

Remitente

from es obligatorio y debe pertenecer a un dominio remitente verificado para la cuenta.

Adjuntos

El archivo debe cargarse primero mediante POST /email/v1/attachments. Para compartir el mismo archivo con todos los destinatarios, coloque attachmentId y attachmentName en la raíz. Para enviar archivos diferentes, coloque ambos campos dentro de cada elemento de payload. No mezcle los dos modos. attachmentName es obligatorio siempre que se envíe un attachmentId.

Programación

Use programmedDate en UTC dentro del destinatario para programar el envío. Omita el campo o envíe null para procesarlo lo antes posible.

Respuesta

El servicio retorna 202 incluso cuando la solicitud o algunos destinatarios fallan validación. Siempre revise overallStatus, errors y el estado individual de recipients.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required

Dirección remitente obligatoria. Debe pertenecer a un dominio verificado para la cuenta.

string

Nombre visible del remitente.

string

Asunto obligatorio cuando se utiliza html. Con templateId, el asunto de la plantilla prevalece y este valor se ignora.

string

Identificador de una plantilla almacenada. Es excluyente con html.

string

Contenido HTML directo. Es excluyente con templateId y requiere subject.

string
required

Identificador retornado por POST /email/v1/attachments para adjuntar el mismo archivo a todos los destinatarios. Requiere attachmentName y no puede combinarse con adjuntos por destinatario.

string
required

Nombre con el que el destinatario verá el adjunto compartido. Es obligatorio si se incluye attachmentId en la raíz.

payload
array of objects
required
length ≥ 1

Destinatarios procesados individualmente.

payload*
string
required

Dirección remitente obligatoria. Debe pertenecer a un dominio verificado para la cuenta.

string

Nombre visible del remitente.

string

Asunto obligatorio cuando se utiliza html. Con templateId, el asunto de la plantilla prevalece y este valor se ignora.

string

Identificador de una plantilla almacenada. Es excluyente con html.

string

Contenido HTML directo. Es excluyente con templateId y requiere subject.

string
required

Identificador retornado por POST /email/v1/attachments para adjuntar el mismo archivo a todos los destinatarios. Requiere attachmentName y no puede combinarse con adjuntos por destinatario.

string
required

Nombre con el que el destinatario verá el adjunto compartido. Es obligatorio si se incluye attachmentId en la raíz.

payload
array of objects
required
length ≥ 1

Destinatarios procesados individualmente.

payload*
Responses

401

API key ausente o no válida.

403

La API key no tiene autorización para ejecutar la operación o el remitente no pertenece a un dominio verificado.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json