finds.dev← search

// the find

gomfunkel/node-mailchimp

★ 357 · JavaScript · MIT · updated Jun 2019

A node.js wrapper for the MailChimp API.

A Node.js wrapper for MailChimp's API covering v1.1 through v2.0, the Export API, Webhooks, OAuth2, and Mandrill. Last touched in 2019, which is the first thing you need to know before considering it. MailChimp has since shipped API v3 and rebranded to Mailchimp Marketing API, making this wrapper a wrapper around deprecated endpoints.

Covers a lot of surface area for its era — webhooks, OAuth2, export streaming, and partner API all in one package rather than requiring separate libraries. The webhook implementation uses an event emitter pattern that maps cleanly to how you'd actually want to consume subscribe/unsubscribe events. Tests exist for each API version, which was more than most wrappers bothered with at the time.

Targets MailChimp API v1.x and v2.0, both of which were sunset years ago — v3 is the current API and it has a completely different structure, so this code won't work against real MailChimp endpoints today. Callback-only interface with no Promise or async/await support, so you'd be wrapping it in promisify just to use it with modern Node. The OAuth2 implementation spins up its own HTTP server on a hardcoded port (8100 by default), which is fragile in any environment where you don't fully control the port. Five years of zero commits means any bugs, auth flow changes, or dependency CVEs are yours to fix.

View on GitHub →

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →