Chimplist makes it very easy and simple to work with Mailchimp's API v3 to manage your Lists(also called Audiences) and their Members.
npm install chimplist
const Chimplist = require("chimplist");
const API_KEY = "your Mailchimp API KEY";
const Chimp = new Chimplist(API_KEY);
/* Using `getAllLists()` function to get information about all lists
* All the available functions with Chimplist are mentioned down below.
* This is how you would work with the new ES6 promise syntax with .then .catch */
Chimp.getAllLists()
.then((response) => {
// Work with the `response` from Mailchimp API
// `response` is a standard HTTP response(Headers, Body, etc).
})
.catch((error) => {
// Handle any errors while running `getAllLists()`
});
// You can use async/await inside try/catch block as well
const functionName = async () => {
try {
const response = await Chimp.getAllLists();
// Work with the `response` from Mailchimp API
} catch (error) {
// Handle any errors while running `getAllLists()`
}
};
// Call the function to execute the try/catch block code
functionName();
A lot of people use Mailchimp for their list
feature. Chimplist aims at the people who quickly just want to add a sign up to newsletter
type of form to their website. This library aims to help them get started working with Mailchimp lists with ease and simplicity by making sure:
- You don't have to worry about the Mailchimp's API end points.
- You don't have to worry about handling authorizations.
- You don't have to worry about knowing how to make HTTP requests.
- You can use it on your back-end with just few lines of code.
Note: At the moment, Chimplist do not support the capability to apply request query parameters
to your API requests for keeping things simple. Maybe in the future that feature might be added, untill then you might like using something like node-mailchimp.
list_id
- The list id(also known as Audience ID) of the specific list you are targeting. Can be found in Audience -> Settings -> Audience name and campaign defaults. Data type is string
.
options
- The data object which contains at least the required request body parameters
. Reference links are provided down below along with those specific functions. Data type is object
.
subscriber_hash
- According to Mailchimp API documentation: "it is The MD5 hash of the lowercase version of the list member's email address". But it's basically the id
of the member
. It looks like 5adgf4de580e68d565db69db203a5c88
. Data type is string
.
-
createList(options) - Create a new list
options
-> to learn more about whatoptions
should contain, refer to mailchimp api documentaion here.
-
getAllLists() - Get information about all lists in the account.
-
getList(list_id) - Get information about a specific list.
-
updateList(list_id, options) - Update a specific list
options
-> To learn more about whatoptions
should contain, refer to Mailchimp API Documentaion here.
- deleteList(list_id) - Delete a specific list
-
addMember(list_id, options) - Add a new list member
options
-> to learn more about whatoptions
should contain, refer to mailchimp api documentaion here. -
getAllMembers(list_id) - Get information about members in a list
-
getMember(list_id, subscriber_hash) - Get information about a specific list memeber.
-
updateMember(list_id, subscriber_hash, options) - Update a specific list memeber.
options
-> to learn more about whatoptions
should contain, refer to mailchimp api documentaion here. -
archiveMember(list_id, subscriber_hash) - Archive a list memeber.
-
deleteMember(list_id, subscriber_hash) - Permanently delete a list member.