Apr 22, 2010

Introducing ChimpKit: MailChimp API Wrapper

Warning: This post is for API junkies and Cocoa developers. If that’s not you, feel free to move along—but be sure to tell your developer friends that MailChimp’s got something new for them.

I bet you’re working on the next highest grossing iPhone or iPad app, aren’t you? Are you using MailChimp to keep in touch with the people who download your app? You should be! Now you can integrate MailChimp functionality, like list subscription, into your iPhone or iPad apps in a few simple steps. I’m excited to announce that we’ve completed work on the initial release of ChimpKit.

What’s ChimpKit?

Sample subscribe form included with CKDialog
Sample subscribe form used with CKDialogController

ChimpKit is an objective-c wrapper for the MailChimp API (developed by Chris Burnett). We’ve given it a home on GitHub and welcome any feedback and/or contributions. All of the API functionality is tucked into a few classes to help you get started.

  • CKList: managing lists, including interest groups and subscriptions
  • CKCampaign: managing campaigns
  • CKHelperMethods: miscellaneous tasks like retrieving ChimpChatter and account details

If you’re familiar with our API, you might have experienced a bit of déjà vu in that class list.

ChimpKit is built on ASIHTTPRequest by All-Seeing Interactive. That means no heavy lifting when talking with a web server. And with ASIHTTPRequest you get a few bells and whistles, like access to progress delegates, cookie support and an easy look at response headers.

To get started, just drop the ChimpKit directory into your XCode project. There’s a pre-built signup controller (CKDialogController) you can use to add signup functionality into your app with almost zero coding. Just set your API Key and List ID and you’re good to go.

And to my Android friends, we’re a few days from releasing something for you as well.