outr / mailgun4s   1.0.18

Contributors Wanted GitHub

Mailgun API implementation in Scala

Codacy Badge Build Status


Updated project originally forked from https://github.com/Nycto/mailgun-scala but since has been completely re-written.

A Scala wrapper around the Mailgun API. Their documentation can be found here:


Currently only supports sending messages, but more functionality will be added as needed or requested.


The following example shows how to instantiate and send an email:

import org.matthicks.mailgun._
import java.io._
import scala.concurrent._
import scala.concurrent.duration._

val mailgun = new Mailgun("samples.mailgun.org", "key-YOUR-MAILGUN-KEY")
val response = mailgun.send(Message.simple(
  from = EmailAddress("nobody@example.com", "Test App"),
  to = List(EmailAddress("mailgun-scala@mailinator.com", "Joe User")),
  subject = "Mailgun4s Rules!",
  text = Some("This is the testing text"),
  html = Some("<html><b>This</b> <i>seems</i> <img src=\"cid:example.jpg\"/> to <h1>work!</h1></html>")
).withInline(new File("example.jpg"), "image/jpeg"))

val result = Await.result(response, Duration.Inf)
println(s"Result: $result")

Adding it to your Project

Add the following directives to your build.sbt file:

libraryDependencies ++= Seq(
    "org.matthicks" %% "mailgun4s" % "1.0.16"


This library is released under the MIT License, which is pretty spiffy. You should have received a copy of the MIT License along with this program. If not, see http://www.opensource.org/licenses/mit-license.php.