Batch email sending
Send up to 50 emails in a single API request by sending an array
of parameters accepted by send email method in a object
.
This is a recommended way to efficiently send emails to a large list of recipients. For example, if you're sending email report every week to all your users, consider batching.
Limitations
- The total size of the request must be less than 10 MB.
Example
const configureSidemail = require("sidemail");
const sidemail = configureSidemail({ apiKey: "replace-with-your-api-key" });
const response = await sidemail.sendEmail([
{
toAddress: "user-1@example.com",
fromAddress: "you@example.com",
fromName: "Your app",
templateName: "Weekly report",
},
{
toAddress: "user-2@example.com",
fromAddress: "you@example.com",
fromName: "Your app",
templateName: "Weekly report",
},
{
toAddress: "user-3@example.com",
fromAddress: "you@example.com",
fromName: "Your app",
templateName: "Weekly report",
}
]);
Returns
The response contains an array
of objects
with an email ID and a status of email on success.
[
{
"id": "5e858953daf20f3aac50a3da",
"status": "queued"
},
{
"id": "5e858953daf20f3aac50a4da",
"status": "queued"
},
{
"id": "5e858953daf20f3aac50a5da",
"status": "queued"
},
]