Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

MailChimp gem with support for all the monkey APIs. **ALPHA RELEASE**

tag: v0.0.2.alpha


Mailchimp is a simple API wrapper public Mailchimp APIs.

This is heavily based on and, and adds support for the private beta release of Mandrill.

While this works for some simple use cases, it comes with warranty of any kind and may not work for your needs yet!

We welcome bug reports and pull requests, and will remove the .alpha label from this gem once we are confident that it should work out of the box for most usage scenarios.


    # This supercedes uakari and gibbon
    $ gem install mailchimp


A MailChimp account, MailChimp API key, and any extra setup/keys for other services/APIs that you want to use.

Basic Usage

See README-api.markdown for details about the API class, which supersedes the Gibbon Gem

    api      ="your_api_key")

See README-sts.markdown for details about the STS class, which supersedes the Uakari Gem

    sts      ="your_api_key")

See README-mandrill for details about the Mandrill class

    mandrill ="your_api_key")


Take a look in the examples/ folder for examples using each of the APIs. The only actions these perform are either read only or only send emails to you or the address you specify, so it's ok to use your real Mailchimp API keys for them. run them like:

    ruby examples/api_example.rb
    ruby examples/sts_example.rb
    ruby examples/mandrill_example.rb


Write tests before you change anything, run tests before you commit anything:

    $ rake test

We welcome concise pull requests that match the style of this gem and have appropriate tests.


See CONTRIBUTORS.markdown for the people that have contributed in some way to this Gem

Something went wrong with that request. Please try again.