Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
gem install madmimi - then send emails, track statistics, and manage your subscriber base with ease... and all with the Ruby syntax you know and love!

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.



The power of Mad Mimi in your Ruby application. Deliver emails, track statistics, and manage your subscriber base with ease.


gem install madmimi - or if you prefer to live on the edge, just clone this repository and build it from scratch.

A brief tutorial

Dependencies: active_support (I intend to remove this in the not too distant future, and build my own implementation.)

mimi ='emailaddress', 'api_key')

mimi.lists -> get all of your Mad Mimi lists returned as a hash

mimi.memberships('email') -> returns a hash of the lists that specific email address is subscribed to

mimi.new_list('New list name') -> make a new list

mimi.delete_list('New list name') -> delete the list I just created

mimi.csv_import(“name,emailndave,dave@example.comn”) -> import from a csv string

mimi.add_to_list('', 'Test List') -> add this email address to a specific list

mimi.remove_from_list('', 'Test List') -> remove this email address from a specific list

mimi.suppressed_since('unix timestamp') -> get a TXT of all addresses that were suppressed since this timestamp

mimi.promotions -> returns a hash of your promotions

mimi.mailing_stats('promotion_id', 'mailing_id') -> get stats on a specific mailing

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2010 Nicholas Young. See LICENSE for details.

Something went wrong with that request. Please try again.