{"componentChunkName":"component---src-pages-markdown-remark-fields-slug-js","path":"/engineering/sending-emails-with-golang/","result":{"data":{"markdownRemark":{"id":"22ca83c0-4d5f-5977-baff-e0bfc911ee4f","excerpt":"Before You Get Started This tutorial assumes you have: A basic understanding of Go Language Latest GoLang version installed on your system A few minutes of your…","html":"

Before You Get Started

\n

This tutorial assumes you have:

\n\n

In this blog, we’ll look at different methods to send an email with Go, First, we will explore inbuilt smtp package, then we will move to use a popular package Gomail and finally, we will send HTML emails using custom templates.

\n

Package smtp

\n

smtp is an inbuilt package provided with Golang. It implements the Simple Mail Transfer Protocol and has multiple functionalities related to it. Here to send the email we will be using only two functions PlainAuth and SendMail from the package.

\n
\n

Note: Click here for an overview on Go Functions

\n
\n\n

Below is the complete code to send a plain text email with smtp package in golang.

\n
package main\n\nimport (\n  "fmt"\n  "net/smtp"\n)\n\nfunc main() {\n\n  // Sender data.\n  from := "from@gmail.com"\n  password := "<Email Password>"\n\n  // Receiver email address.\n  to := []string{\n    "sender@example.com",\n  }\n\n  // smtp server configuration.\n  smtpHost := "smtp.gmail.com"\n  smtpPort := "587"\n\n  // Message.\n  message := []byte("This is a test email message.")\n  \n  // Authentication.\n  auth := smtp.PlainAuth("", from, password, smtpHost)\n  \n  // Sending email.\n  err := smtp.SendMail(smtpHost+":"+smtpPort, auth, from, to, message)\n  if err != nil {\n    fmt.Println(err)\n    return\n  }\n  fmt.Println("Email Sent Successfully!")\n}
\n
\n

In the above code example we have used smtp details of a Gmail account, you should update the smtp detail according to your email provider.

\n
\n
\n

Just to explain things easily, In the above snippet, we have written all the smtp and email credentials in the main function, Though in a production app you should always use env variables for configurations. You can check Viper to manage configurations in production apps.

\n
\n

Package Gomail

\n

Below is the complete code to send a plain text email with Gomail package in golang.

\n
package main\n\nimport (\n  "crypto/tls"\n  "fmt"\n\n  gomail "gopkg.in/mail.v2"\n)\n\nfunc main() {\n  m := gomail.NewMessage()\n\n  // Set E-Mail sender\n  m.SetHeader("From", "from@gmail.com")\n\n  // Set E-Mail receivers\n  m.SetHeader("To", "to@example.com")\n\n  // Set E-Mail subject\n  m.SetHeader("Subject", "Gomail test subject")\n\n  // Set E-Mail body. You can set plain text or html with text/html\n  m.SetBody("text/plain", "This is Gomail test body")\n\n  // Settings for SMTP server\n  d := gomail.NewDialer("smtp.gmail.com", 587, "from@gmail.com", "<email_password>")\n\n  // This is only needed when SSL/TLS certificate is not valid on server.\n  // In production this should be set to false.\n  d.TLSConfig = &tls.Config{InsecureSkipVerify: true}\n\n  // Now send E-Mail\n  if err := d.DialAndSend(m); err != nil {\n    fmt.Println(err)\n    panic(err)\n  }\n\n  return\n}
\n

Custom HTML Templates

\n

Now, let's send an HTML email with smtp package, for this, we need to create two files in the root folder.

\n\n
<!-- template.html -->\n<!DOCTYPE html>\n<html>\n<body>\n    <h3>Name:</h3><span>{{.Name}}</span><br/><br/>\n    <h3>Email:</h3><span>{{.Message}}</span><br/>\n</body>\n</html>
\n

We are using text/template package to parse HTML files and use it in smtp SendMail function.

\n
package main\n\nimport (\n  "bytes"\n  "fmt"\n  "net/smtp"\n  "text/template"\n)\n\nfunc main() {\n\n  // Sender data.\n  from := "from@gmail.com"\n  password := "<Email Password>"\n\n  // Receiver email address.\n  to := []string{\n    "sender@example.com",\n  }\n\n  // smtp server configuration.\n  smtpHost := "smtp.gmail.com"\n  smtpPort := "587"\n\n  // Authentication.\n  auth := smtp.PlainAuth("", from, password, smtpHost)\n\n  t, _ := template.ParseFiles("template.html")\n\n  var body bytes.Buffer\n\n  mimeHeaders := "MIME-version: 1.0;\\nContent-Type: text/html; charset=\\"UTF-8\\";\\n\\n"\n  body.Write([]byte(fmt.Sprintf("Subject: This is a test subject \\n%s\\n\\n", mimeHeaders)))\n\n  t.Execute(&body, struct {\n    Name    string\n    Message string\n  }{\n    Name:    "Puneet Singh",\n    Message: "This is a test message in a HTML template",\n  })\n\n  // Sending email.\n  err := smtp.SendMail(smtpHost+":"+smtpPort, auth, from, to, body.Bytes())\n  if err != nil {\n    fmt.Println(err)\n    return\n  }\n  fmt.Println("Email Sent!")\n}
\n

Once done you need to run below command to send the emails

\n
go run main.go
\n
\n

If you don't want to create your custom HTML emails, Hermes is a package that generates clean, responsive HTML e-mails for sending transactional e-mails.

\n
\n

Now you can send beautiful emails to the customer by your golang application, You can found the complete code used in this blog on our Github Repo

\n","headings":[{"value":"Before You Get Started","depth":2},{"value":"Package smtp","depth":2},{"value":"Package Gomail","depth":2},{"value":"Custom HTML Templates","depth":2}],"fields":{"slug":"/engineering/sending-emails-with-golang/"},"frontmatter":{"metatitle":null,"metadescription":null,"description":"In this blog, we’ll look at different methods to send an email with Go, First we will explore inbuilt smtp package, then we will move to use a popular package Gomail and finally we will send HTML emails using custom templates.","title":"Different ways to send an email with Golang","canonical":null,"date":"August 03, 2020","updated_date":null,"tags":["Go","Email"],"coverImage":{"childImageSharp":{"fluid":{"aspectRatio":1.5037593984962405,"src":"/static/0ac40484af2392675963fb3327b3dbb4/701ee/email_cover.jpg","srcSet":"/static/0ac40484af2392675963fb3327b3dbb4/3dcee/email_cover.jpg 200w,\n/static/0ac40484af2392675963fb3327b3dbb4/ae6ae/email_cover.jpg 400w,\n/static/0ac40484af2392675963fb3327b3dbb4/701ee/email_cover.jpg 800w,\n/static/0ac40484af2392675963fb3327b3dbb4/8c3c2/email_cover.jpg 1200w,\n/static/0ac40484af2392675963fb3327b3dbb4/c120e/email_cover.jpg 1600w,\n/static/0ac40484af2392675963fb3327b3dbb4/cd33f/email_cover.jpg 1800w","sizes":"(max-width: 800px) 100vw, 800px"}}},"author":{"id":"Puneet Singh","github":"puneetsingh24","bio":"Very curious about this world and blogging whenever learning something new","avatar":null}}}},"pageContext":{"id":"22ca83c0-4d5f-5977-baff-e0bfc911ee4f","fields__slug":"/engineering/sending-emails-with-golang/","__params":{"fields__slug":"engineering"}}},"staticQueryHashes":["1171199041","1384082988","1711371485","1753898100","2100481360","229320306","23180105","528864852"]}