Support tagging

mailgun.rb

@@ -65,6 +65,8 @@ def prepare_request(url_string)
 class MailgunMessage
   extend Mailgun::RequestBuilder
 
+  MAILGUN_TAG = 'X-Mailgun-Tag'
+
   # Sends a MIME-formatted message
   #
   #  raw_mime =
@@ -90,9 +92,12 @@ def self.send_raw(sender, recipients, raw_body, servername='')
   #      "Subject",
   #      "Hi!\nThis is message body")
   #
-  def self.send_text(sender, recipients, subject, text, servername='')
+  def self.send_text(sender, recipients, subject, text, servername='', options = nil)
     uri_str = "#{MailgunResource.site}messages.txt?api_key=#{MailgunResource.password}&servername=#{servername}"
     params = { :sender => sender, :recipients => recipients, :subject => subject, :body => text}
+    unless options.nil?
+      params['options'] = ActiveSupport::JSON.encode(options)
+    end
     http, url = prepare_request(uri_str)
     req = Net::HTTP::Post.new(url)
     req.set_form_data(params)

samples/sending-messages.rb

@@ -4,19 +4,28 @@
 
 # Sending a simple text message:
 MailgunMessage::send_text("me@samples.mailgun.org",
-                  "you@yourhost, 'Him' <you@mailgun.info>",
-                  "Hello",
-                  "Hi!\nI am sending the message using Mailgun Ruby API")
+                          "you@yourhost, 'Him' <you@mailgun.info>",
+                          "Hello text Ruby API",
+                          "Hi!\nI am sending the message using Mailgun Ruby API")
+
+# Sending a simple text message + tag
+MailgunMessage::send_text("me@samples.mailgun.org",
+                          "you@yourhost, 'Him' <you@mailgun.info>",
+                          "Hello text Ruby API",
+                          "Hi!\nI am sending the message using Mailgun Ruby API",
+                          "",
+                          {:headers => {MailgunMessage::MAILGUN_TAG => "sample_text_ruby"}})
 
 # Sending a MIME message:
 sender   = "me@samples.mailgun.org"
 receiver = "you@mailgun.info"
 raw_mime =
+  "X-Mailgun-Tag: sample_raw_ruby" +
   "Content-Type: text/plain;charset=utf-8\n" +
   "From: #{sender}\n" +
   "To: #{receiver}\n" +
   "Content-Type: text/plain;charset=utf-8\n" +
-  "Subject: Hello!\n" +
+  "Subject: Hello raw Ruby API!\n" +
   "\n" +
   "Sending the message using Mailgun Ruby API"
 MailgunMessage::send_raw(sender, receiver, raw_mime)