I took ntlzz93's package and added some more features.
Current version is 0.9.1, I will add all the functions before the launch of 1.0.0
To to know which API is available and params, go to api directory.
This SDK are using native Promise instead of Callback, so you can async/await as you want
First, you need to add the configuration:
const mailWizz = require("node-mailwizz");
const config = {
publicKey: "publicKey",
secret: "secretKey",
baseUrl: "yourMailwizzApiUrl"
};
How to create a subscriber:
const subscribers = new mailWizz.ListSubscribers(config);
var userInfo = { //replace the values with your user info
EMAIL: "hi@mikelcalvo.me",
FNAME: "Mikel",
LNAME: "Calvo",
CUSTOM: "custom"
};
//You can replace CUSTOM with the parameters you want
subscribers.create("LIST-UNIQUE-ID", userInfo)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to update a subscriber:
const subscribers = new mailWizz.ListSubscribers(config);
var userInfo = { //replace the values with your user's new info
EMAIL: "hi@mikelcalvo.me",
FNAME: "Mikel",
LNAME: "Calvo",
CUSTOM: "custom"
};
//You can replace CUSTOM with the parameters you want
subscribers.update("LIST-UNIQUE-ID", "SUBSCRIBER-UNIQUE-ID", userInfo)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to delete a subscriber:
const subscribers = new mailWizz.ListSubscribers(config);
subscribers.delete("LIST-UNIQUE-ID", "SUBSCRIBER-UNIQUE-ID")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to get your subscribers:
const subscribers = new mailWizz.ListSubscribers(config);
/Value 1 is the page number you want to get
//Value 10 is the items per package
//So if you set (1, 10) it will get the first 10 subscribers
subscribers.getSubscribers("LIST-UNIQUE-ID", 1, 10)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to get a subscriber with their id:
const subscribers = new mailWizz.ListSubscribers(config);
subscribers.getSubscriber("LIST-UNIQUE-ID", "SUBSCRIBER-UNIQUE-ID")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to get a subscriber with their email:
const subscribers = new mailWizz.ListSubscribers(config);
subscribers.emailSearch("LIST-UNIQUE-ID", "SUBSCRIBER-EMAIL")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to get your lists:
const lists = new mailWizz.Lists(config);
//Value 1 is the page number you want to get
//Value 10 is the items per package
//So if you set (1, 10) it will get the first 10 lists
lists.getLists(1, 10)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
If you have your list id you can directly get it:
const lists = new mailWizz.Lists(config);
lists.getList("LIST-UNIQUE-ID")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to create a new list:
const lists = new mailWizz.Lists(config);
var listInfo = { //Replace the values with your list info
name: "Main List", //Required
description: "This is a test list", //Required
optIn: "single", //single or double
optOut: "single", //single or double
fromName: "Mikel Calvo", //Required
fromEmail: "hi@mikelcalvo.me", //Required
replyTo: "hi@mikelcalvo.me", //Required
subject: "Hi!",
//notification when new subscriber added
notificationSubscribe: "yes", //yes or no
notificationUnsubscribe: "yes", //yes or no
//where to send the notification
notificationSubscribeTo: "hi@mikelcalvo.me",
notificationUnsubscribeTo: "hi@mikelcalvo.me",
//This is optional, if not set customer company data will be used:
companyName: "Mikel Calvo SL", //required
companyCountry: "Spain", //required
companyZone: "Community of Madrid", //required
companyAddress1: "Some street address", //required
companyAddress2: "",
companyZoneName: "", //when country doesn't have required zone
companyCity: "Madrid",
companyZipCode: "28013",
};
lists.create(listInfo)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to copy a list:
const lists = new mailWizz.Lists(config);
lists.copy("LIST-UNIQUE-ID")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to remove a list:
const lists = new mailWizz.Lists(config);
lists.delete("LIST-UNIQUE-ID")
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});
How to update a list:
const lists = new mailWizz.Lists(config);
var newInfo = { //Replace the values with your updated list info
name: "Main List", //Required
description: "This is a test list", //Required
optIn: "single", //single or double
optOut: "single", //single or double
fromName: "Mikel Calvo", //Required
fromEmail: "hi@mikelcalvo.me", //Required
replyTo: "hi@mikelcalvo.me", //Required
subject: "Hi!",
//notification when new subscriber added
notificationSubscribe: "yes", //yes or no
notificationUnsubscribe: "yes", //yes or no
//where to send the notification
notificationSubscribeTo: "hi@mikelcalvo.me",
notificationUnsubscribeTo: "hi@mikelcalvo.me",
//This is optional, if not set customer company data will be used:
companyName: "Mikel Calvo SL", //required
companyCountry: "Spain", //required
companyZone: "Community of Madrid", //required
companyAddress1: "Some street address", //required
companyAddress2: "",
companyZoneName: "", //when country doesn't have required zone
companyCity: "Madrid",
companyZipCode: "28013",
};
lists.update("LIST-UNIQUE-ID", newInfo)
.then(function(result) {
//TODO: do what you want
})
.catch(function(err) {
//handle error here
});