SENDO EMAIL API

Email Sending API to send notifications to your customers. The request supports one or multiple destinations and allows sharing an html template in each request or referencing a predefined template in the Sendo user interface.


Send Email

POSThttps://api.sendo.cloud/api/email/send

This endpoint is used to send templated email to a specific destination.

Required attributes


FieldTypeDescription
destinationstringThe email address of the recipient to whom the email will be sent.
htmlstring Contains the body of the email in HTML format. It allows including HTML tags to format the content of the email. In this case, placeholder tags like {{name}} are used, which will be replaced by the corresponding values provided in the emailVariables object.
subjectstringThe subject of the email that the recipient will see.
senderstringThe sender's email address previously approved and configured correctly.
emailVariablesobjectAn object that contains variables to be inserted into the body of the email. In this case, it includes variables as a name with its respective value that will be used to replace the placeholder tags in the HTML.
timeZonestringThe time zone used to process email delivery.

Request body.


curl --location 'https://35.185.103.32:3000/api/email/send' 
--header 'apikey: fQbUHC3LPDQxUsdfsv6545gfdgKBRkImwePfwz' 
--header 'Content-Type: application/json' 
--data-raw  '{
"destination": "john.dou@yourmail.com",
"html": "<h1>Hola {{Name}}, hoy es {{Fecha}} ppp {{Phone}}</h1>",
"subject": "EMAIL DE PRUEBA",
"sender": "example@yourmail.com",
"emailVariables": {"name":"John Doe","fecha":"8-08-2088","phone":"83347715"},
"timeZone": "America/Guayaquil"
}'
Response .
CodeDescription
200Successful
{
  "status": {
    "code": 200,
    "message": "Envío exitoso",
    "messageId": "68c9802d-1910-4dba-9048-4a6c98787a0e"
  }
}

Server responses.

Send email by template

POSThttps://api.sendo.cloud/api/email/send-by-template

This endpoint is used to send email by adding the ID of the Sendo platform templates.

Required attributes


FieldTypeDescription
destinationstringThe email address of the recipient to whom the email will be sent.
templateReferencestringID extracted from the Email template of the Sendo platform.
subjectstringThe subject of the email that the recipient will see.
senderstringThe sender's email address previously approved and configured correctly.
personobjectAn object that contains variables to be inserted into the body of the email. In this case, it includes variables as a name with its respective value that will be used to replace the placeholder tags in the HTML.
timeZonestringThe time zone used to process email delivery.

Request body.


curl --location 'https://35.185.103.32:3000/api/email/send-by-template' 
--header 'apikey: fQbUHC3LPDQxUsdfsv6545gfdgKBRkImwePfwz' 
--header 'Content-Type: application/json' 
--data-raw   '{
"destination": "john.dou@yourmail.com",
"templateReference": 0,
"subject": "TEST EMAIL",
"sender": "example@yourmail.com",
"person": {"name":"john wek","fecha":"8-08-2088","phone":"83347715"},
"timeZone": "America/Guayaquil"
}'
Response .
CodeDescription
200Successful
{
  "status": {
    "code": 200,
    "message": "Envío exitoso",
    "messageId": "68c9802d-1910-4dba-9048-4a6c98787a0e"
  }
}

Server responses.