Nov 16, 2007

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 AIM 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,

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!