Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ruby gem for sending emails through http://postmarkapp.com HTTP API

branch: master

This branch is 0 commits ahead and 0 commits behind master

Fetching latest commit…

Cannot retrieve the latest commit at this time

README.rdoc

Postmark Gem

This gem is an official wrapper for Postmark HTTP API (postmarkapp.com). Use it to send emails and retrieve info about bounces.

Install

gem install postmark

In addition to the postmark gem you also need to install tmail or mail gem. Pick the one you like most:

gem install mail
- or -
gem install tmail

TMail Example

require 'rubygems'
require 'postmark'
require 'tmail'

Postmark.api_key = "your-api-key"

# Make sure you have a sender signature for every From email you specify.
# From can also accept array of addresses.   

message              = TMail::Mail.new
message.from         = "leonard@bigbangtheory.com"
message.to           = "Sheldon Cooper <sheldon@bigbangtheory.com>"
message.subject      = "Hi Sheldon!"
message.content_type = "text/html"
message.body         = "Hello my friend!"

# You can set customer headers if you like:
message["CUSTOM-HEADER"] = "my custom header value"

# Added a tag:
message.tag = "my-tracking-tag"

# Add attachments:
message.postmark_attachments = [File.open("/path"), File.open("/path")]

# Add attachments with content generated on the fly:
message.postmark_attachments = [{
    "Name" => "September 2011.pdf",
    "Content" => [pdf_content].pack("m"),
    "ContentType" => "application/pdf"
}]

# Or specify a reply-to address (can also be an array of addresses):
message.reply_to = "penny@bigbangtheory.com"

Postmark.send_through_postmark(message)

Mail Example

require 'rubygems'
require 'postmark'
require 'mail'

message = Mail.new
message.delivery_method(Mail::Postmark, :api_key => "your-api-key")
# ...
# same as in example above
# ...
message.deliver

Other API Features

You can retrieve various information about your server state using the Public bounces API - developer.postmarkapp.com/bounces

# Get delivery stats: (JSON format)
Postmark.delivery_stats

# Get bounces information: (array of bounce objects)    
Postmark::Bounce.all

# Find specific bounce by id:    
bounce = Postmark::Bounce.find(bounce_id)    
bounce.dump     # string, containing raw SMTP data
bounce.activate # reactivate hard bounce

Encryption

To use SSL encryption when sending email configure the library as follows:

Postmark.secure = true

Requirements

The gem relies on TMail or Mail for building the message. You will also need postmark account, server and sender signature set up to use it. If you plan using it in a rails project, check out the postmark-rails gem, which is meant to integrate with ActionMailer.

The plugin will try to use ActiveSupport Json if it is already included. If not, it will attempt using the built-in ruby Json library. You can also explicitly specify which one to be used, using

Postmark.response_parser_class = :Json # :ActiveSupport or :Yajl is also supported.

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.

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

Authors & Contributors

  • Petyo Ivanov

  • Ilya Sabanin

  • Hristo Deshev

  • Artem Chistyakov

  • Randy Schmidt

  • Chris Williams

  • Aitor García Rey

  • James Miller

  • Yury Batenko

  • Pavel Maksimenko

  • Anton Astashov

Copyright

Copyright © 2012 Wildbit LLC. See LICENSE for details.

Something went wrong with that request. Please try again.