Building GoPhish - How to Send Email with Go


I’ve been playing around with Go for about a month now, and I’ve really grown to like it. After getting used to the syntax and remembering what a pointer is for (thanks, Python), Go has become a favorite language to develop with. I’m even using it for the Matasano Crypto Challenges (which are awesome).

While the standard library in Go is definitely robust, being a young language, there are a few niceties that aren’t yet included. Sending email is one of them. Don’t get me wrong, Go has a wonderful SMTP package, MIME package, and even a Mail package (which only parses existing email messages). However, there is no library to actually create emails in a meaningful way. Since Gophish relies heavily on sending emails, I’ve sought to change this. And, after reading more RFC’s than I normally prefer, I believe I’ve created a package that provides intuitive, robust, and flexible email creation and sending called email.

Let’s see how to use it.

How You Normally Send an Email in Go

To send email in Go, one needs to:

  • Create a byte slice of the email message (conforming to all needed RFC’s)
  • Send this email using the SMTP library

The second part is easy, the first part is not. Sure, sending a simple text message may be straight forward, but things get tricky when you want to cover things like supporting HTML and text body types, attaching files, supporting CC and BCC recipients, etc.

Sending Email Using the email Package

To make this easier, I have created the email package (full documentation here). This package allows users to create emails with a variety of options, and send them easily. Examples say more than I can, so here is some code showing how to use the package.

Installing the Package

go get

Creating a New Email

package main

import ""

func main() {
	e := email.NewEmail()

Setting the Subject, To, From, Bcc, Cc

e.Subject = "Awesome Subject"
e.From = "Jordan Wright <>"
e.To = []string{""}
e.Bcc = []string{""}
e.Cc = []string{""}

Setting the Content (HTML & Text)

e.Text = "Text Body is, of course, supported!"
e.HTML = "<h1>Fancy Html is supported, too!</h1>"

Attaching a File


You can also use the Attach function to attach content directly from an io.Reader.

Sending the Email (Using Gmail as Example)

e.Send("", smtp.PlainAuth("", "", "password123", ""))


I hope this package will be useful to those that need to send email from their Go projects. I am excited to continue working on Gophish - you can expect a big update soon! Until then, as always, feel free to leave any questions or comments below.

-Jordan (@jw_sec)

Jordan Wright

Security Researcher, Programmer, Time's 2006 Person of the Year

San Antonio, Texas