Skip to content


Folders and files

Last commit message
Last commit date

Latest commit


Repository files navigation


Gem Version Test Status

Ruby client for the Mailgun API.


$ gem install mailgunner


require 'mailgunner'

Mailgunner.configure do |config|
  config.domain = ''
  config.api_key = 'key-3ax6xnjp29jd6fds4gc373sgvjxteol0'

mailgun =

mailgun.get_domains.items.each do |item|
  puts "#{} #{}"

Storing the API key

Best practice for credentials is to store them in the environment. Mailgunner::Client defaults to extracting the domain and api_key values it needs from the MAILGUN_API_KEY and MAILGUN_SMTP_LOGIN environment variables—these will exist if you are using Mailgun on Heroku, or you can set them manually.

ActionMailer integration

Mailgunner integrates with ActionMailer. If you are using Rails, you can use Mailgunner to send mail via Mailgun by adding the following line to config/environments/production.rb:

config.action_mailer.delivery_method = :mailgun

If for some reason you can't set the required ENV variables, you can configure Mailgunner through ActionMailer settings:

config.action_mailer.mailgun_settings = {
  domain: '',
  api_key: 'your-api-key'

Outside of Rails you can set ActionMailer::Base.delivery_method directly.

Specifying the region

Mailgun offers both a US and EU region to send your email from. Mailgunner uses the US region by default. If you wish to use the EU region set the api_host config option like so:

Mailgunner.configure do |config|
  config.api_host = ''