mailgun library for ruby
Pull request Compare This branch is 17 commits behind cloudfuji:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This gem allows for idiomatic Mailgun usage from within ruby. Mailgun is a kickass email-as-a-service that lets you use email as if it made sense. Check it out at

The official gem repo is at

Mailgun exposes the following resources:

  • Routes
  • Log
  • Stats
  • Messages
  • Mailboxes

Currently the gem only exposes the Mailbox API, but patches are welcome (and easy!).


We mimic the ActiveRecord-style interface.

# Initialize your Mailgun object:
@mailgun = Mailgun(:api_key => 'your-api-key')

# Create a mailbox
@mailgun.mailbox.create "", "password"

# List all mailboxes that belong to a domain
@mailgun.mailboxes.list ""

# Destroy a mailbox (queue bond-villian laughter)
# "I'm sorry Bond, it seems your mailbox will be... destroyed!"
@mailbox.mailboxes.destroy ""

Making Your Changes

  • Fork the project (Github has really good step-by-step directions)
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so we don't break it in a future version unintentionally.
  • After making your changes, be sure to run the Mailgun RSpec specs to make sure everything works.
  • Submit your change as a Pull Request and update the GitHub issue to let us know it is ready for review.



Huge thanks to the Mailgun guys for such an amazing service! No time spent on mailservers == way more time spent drinking!

License & Copyright

Released under the MIT license. See LICENSE for more details.

All copyright Bushido Inc. 2011