MonkeyBrains! The Official MailChimp Blog about email marketing and monkeys

Monkey Brains   WWW

« Before You Hit Send, Consult Your Email Checklist | Main | Gmail Breaking Cellpadding »

API Upgrade (for nerds only)

If you're one of the web geeks who use MailChimp, we've got something you might want to tinker with over turkey day (yeah, we know you're gonna be online).

If you're a marketing person who uses MailChimp, ignore this. We'll be sending out an official email (with cool, pretty pictures) for you after Thanksgiving.

Fellow Nerds:

We've just completely overhauled the MailChimp API. If you're using the older API, don't freak---it still works. But there's so much more you can do with the new API.

What's different?

In a nutshell, the old API just accepted data from you. It was a one-way street. With the new API, MailChimp talks back. A lot...

If you've ever said, "Man, if only MailChimp's API would sync back with my internal database, I could _____. " Then you'll love this.

You can now pull just about any piece of data you want from MailChimp. Some ideas:

  • Download unsubs, bounces, FBL reports, etc. from MC to clean your inhouse lists
  • Pull campaign stats from MC, and assemble your own crazy reports
  • If you've got our A.I.M. Reports add-on, sync recipient email activity (like opens/clicks) to your customer database to do some "behavioral targeting" (make sure you give your marketing person ample warning before you mention this, because they will crap their pants as soon as the words come out your mouth)
  • Pass customer status (like subscription info) into MailChimp, and only send campaigns to "active" members
  • Do you send campaigns on behalf of clients? Create special pages for them in your CMS, where they can vew their campaign stats

Some new functionality you can do with the API:

  • BatchUnsubscribe
  • Sending the double opt-in confirmation is now optional for API-imported lists. If you've handled opt-ins on your end, no need to re-confirm them again when passing to MailChimp. But it's on by default, just in case you need it.

The new API makes it easier than ever to add the power of "THE CHIMP" into your CRM, CMS, or e-Commerce system. Oh wait, I thought I was talking to the marketing people again. Sorry. Back to the nerdy stuff...

The API is available in three forms – php, which is what our auto-generated client class uses, using php serialization strings, JSON, and XML-RPC.

You can read the auto-generated documentation at:

(we're not finished polishing these pages, but we thought we'd get this posted asap before the holiday break)

The auto-generated PHP client class can be seen here:

Happy Thanksgiving!

November 16, 2007 in MailChimp News | Permalink


TrackBack URL for this entry:

Listed below are links to weblogs that reference API Upgrade (for nerds only):


Fancy that. I wrote a class for the MailChimp API the day this was posted.

But the new features are going to be very useful. Nice work on all this =]

Posted by: Don Schonknecht | Nov 22, 2007 12:56:50 PM

The comments to this entry are closed.

MonkeyBrains! is the official MailChimp Blog. MailChimp is a product of The Rocket Science Group.