mandrill node client

A super simple mandrill client.

This client can:

• Send emails based on a template
• Set variables within emails
• Schedule emails
• Reschedule emails (provided you saved the schedule id)

This client is:

• Well typed (i think)
• Super simple

This client requires:

• A valid mandrill api key
• Email templates in mandrill

Usage example

Initialize Client

Here you'll need a Mandrill API Key. Check out Mailchimp Transaction documentation for more info.

Note: Mailchimp Transactional is just a name for mandrill.

import { MailClient } from  "simple-mandrill-client";
const mail = new MailClient(YOUR_MANDRILL_API_KEY_HERE);

Send email

For sending and scheduling emails you'll need a template defined. My preferred way of doing this is to create the template in Mailchimp first and then sending the template to mandrill. There are many ways to define a template; pick your favorite.

mail.sendEmail({
    from: {
        email: "myemail@mydomain.com",
        name: "My name",
    },
    recepient: recepient-email@domain.com,
    subject: `Subject Line`,
    template: `template-name`,
    variables: {
        VARIABLE_A: foo,
        VARIABLE_B: bar
    } // merge fields as defined in template (can also be {} if you don't have any variables)
});

Schedule and Reschedule Email

const sendAtDate = new Date("2025-01-01T00:00:00+00:00"); // jan 1st 2025 midnight
cosnt id = await mail.sendEmail({
    from: {
        email: "myemail@mydomain.com",
        name: "My name",
    },
    recepient: recepient-email@domain.com,
    subject: `Subject Line`,
    template: `template-name`,
    variables: {
        VARIABLE_A: foo,
        VARIABLE_B: bar
    },
    sendAt: sendAtDate
}).then(res=>res[0].id) // get the id from the response
// the id could be undefined if the email didn't get scheduled (bad template, bad email, etc.)
if(id){
    // reschedule the email
    const newDate = new Date(""2025-01-01T12:00:00+00:00"")
    rescheduleEmail({scheduledId: id, sendAt: newDate});
} 

Note that if the date is in the past; the email will be sent immediately .

Canceled Scheduled Email

mail.cancelScheduledEmail(id)

the id variable used here should be taken from the sendEmail response