post https://api4.optimove.net/TransactionalMail/SendFinalizedTransactionalMail
Sends a transactional email template, containing your custom HTML content, to a list of recipients.
Notes
- BrandID – The ID of your transactional account (if you don't have this ID, contact your CSM).
- Type – The MIME type of the attachment (e.g., "text/plain", "text/html", "application/pdf").
- UniqueMessageID enforces idempotency. This is limited to 254 characters.
- IsSuccess – true is returned if the send was successful. Otherwise, false.
- SendID – If the send failed, null is returned.
- Error – A description of the error. When the send succeeds, null is returned. If the specified template is invalid, Error contains "Invalid template". If idempotency is enforced a 409 error code shows with the following message "Request for this UniqueMessageID has succeeded before".
- Each call may include a maximum of 200 email recipients.
- This function supports a maximum of 10 calls in parallel.
Sample Request
{
"BrandID":99,
"FromEmail":"[news@lovley.com](mailto:news@lovley.com)",
"FromName":"Lovely.com",
"ReplyTo":"[news@lovley.com](mailto:news@lovley.com)",
"Subject":"Check out today's hot deals!",
"Html":"html content goes here",
"PlainText":"plain text content goes here",
"Recipients":\[
{"Email":"[vivi@somedomain.com](mailto:vivi@somedomain.com)"},
{"Email":"[tommy@somedomain.com](mailto:tommy@somedomain.com)"}
],
"Attachments":\[{
"Content":"/_Base64 Encoded Content_/",
"Type":"application/pdf",
"FileName":"hotdealcoupons.pdf"
}],
"UniqueMessageID" (optional):"87ba42c0-9431-4266-b808-01cf05867006"
}
Sample Response
{"IsSuccess":true,"SendID":235311,"Error":null}
{"IsSuccess":false,"SendID":null,"Error":"Invalid template"}