Skip to content
main
Switch branches/tags
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

mailgunner

Gem Version Build Status

Ruby client for the Mailgun API.

Installation

$ gem install mailgunner

Usage

require 'mailgunner'

Mailgunner.configure do |config|
  config.domain = 'samples.mailgun.org'
  config.api_key = 'key-3ax6xnjp29jd6fds4gc373sgvjxteol0'
end

mailgun = Mailgunner::Client.new

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

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: 'test.com',
  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 = 'api.eu.mailgun.net'
end