[mailjet]: http://www.mailjet.com [apicredential]: https://app.mailjet.com/account/apikeys [doc]: http://dev.mailjet.com/guides/?go#

Official Mailjet Go Client

Overview

This repository contains the official Go wrapper for the Mailjet API.

Check out all the resources and in the [Official Documentation][doc].

Table of contents

• Compatibility
• Installation
• Authentication

• Make your first call
• Client / Call configuration specifics

• Request examples

• Contribute

Compatibility

Our library requires Go version 1.13 or higher. But since each major Go release is supported until there are two newer major releases, there is no guarantee that it will be working on unsupported Go versions.

NOTE: Backward compatibility has been broken with the v3.0 release which includes versioned paths required by go modules (See Releasing Modules).

Installation

Get package:

go get github.com/mailjet/mailjet-apiv3-go/v4

And import the Mailjet wrapper:

import (
	"github.com/mailjet/mailjet-apiv3-go/v4"
	"github.com/mailjet/mailjet-apiv3-go/v4/resources"
)

Authentication

The Mailjet Email API uses your API and Secret keys for authentication. [Grab][api_credential] and save your Mailjet API credentials.

export MJAPIKEYPUBLIC='your API key'
export MJAPIKEYPRIVATE='your API secret'

Then initialize your Mailjet client:

// Get your environment Mailjet keys and connect
publicKey := os.Getenv("MJAPIKEYPUBLIC")
secretKey := os.Getenv("MJAPIKEYPRIVATE")
mj := mailjet.NewMailjetClient(publicKey, secretKey)

Functional test

In the tests folder you will find a small program using the wrapper. It can be used to check whether the Mailjet API keys in your environment are valid and active.

go run main.go

Make your first call

Here's an example on how to send an email:

package main
import ( 	"fmt" 	"log" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	messagesInfo := []mailjet.InfoMessagesV31{ 		{ 			From: &mailjet.RecipientV31{ 				Email: "pilot@mailjet.com", 				Name:  "Mailjet Pilot", 			}, 			To: &mailjet.RecipientsV31{ 				mailjet.RecipientV31{ 					Email: "passenger1@mailjet.com", 					Name:  "passenger 1", 				}, 			}, 			Subject:  "Your email flight plan!", 			TextPart: "Dear passenger 1, welcome to Mailjet! May the delivery force be with you!", 			HTMLPart: "<h3>Dear passenger 1, welcome to <a href=\"https://www.mailjet.com/\">Mailjet</a>!</h3><br />May the delivery force be with you!", 		}, 	} 	messages := mailjet.MessagesV31{Info: messagesInfo} 	res, err := mailjetClient.SendMailV31(&messages) 	if err != nil { 		log.Fatal(err) 	} 	fmt.Printf("Data: %+v\n", res) }

Client / Call configuration specifics

Base URL

The default base domain name for the Mailjet API is https://api.mailjet.com. You can modify this base URL by adding a different URL in the client configuration for your call:

mailjetClient := NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE"), "https://api.us.mailjet.com")

If your account has been moved to Mailjet's US architecture, the URL value you need to set is https://api.us.mailjet.com.

Send emails through proxy

package main
import ( 	"fmt" 	"log" 	"net/http" 	"net/url" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" )
// Set the http client with the given proxy url func setupProxy(proxyURLStr string) *http.Client { 	proxyURL, err := url.Parse(proxyURLStr) 	if err != nil { 		log.Fatal(err) 	} 	tr := &http.Transport{Proxy: http.ProxyURL(proxyURL)} 	client := &http.Client{} 	client.Transport = tr
return client }
func main() { 	publicKey := os.Getenv("MJAPIKEYPUBLIC") 	secretKey := os.Getenv("MJAPIKEYPRIVATE") 	proxyURL  := os.Getenv("HTTP_PROXY")
mj := mailjet.NewMailjetClient(publicKey, secretKey)
// Here we inject our http client configured with our proxy 	client := setupProxy(proxyURL) 	mj.SetClient(client)
messagesInfo := []mailjet.InfoMessagesV31{ 		{ 			From: &mailjet.RecipientV31{ 				Email: "qwe@qwe.com", 				Name:  "Bob Patrick", 			}, 			To: &mailjet.RecipientsV31{ 				mailjet.RecipientV31{ 					Email: "qwe@qwe.com", 				}, 			}, 			Subject:  "Hello World!", 			TextPart: "Hi there !", 		}, 	}
messages := &mailjet.MessagesV31{Info: messagesInfo}
res, err := mj.SendMailV31(messages) 	if err != nil { 		fmt.Println(err) 	} else { 		fmt.Println("Success") 		fmt.Println(res) 	} }

Request examples

POST request

Simple POST request

// Create a new contact.
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	var data []resources.Contact 	mr := &mailjet.Request{ 		Resource: "contact", 	} 	fmr := &mailjet.FullRequest{ 		Info: mr, 		Payload: &resources.Contact{ 			Email:                   "passenger@mailjet.com", 			IsExcludedFromCampaigns: true, 			Name:                    "New Contact", 		}, 	} 	err := mailjetClient.Post(fmr, &data) 	if err != nil { 		fmt.Println(err) 	} 	fmt.Printf("Data array: %+v\n", data) }

Using actions

// Create : Manage a contact subscription to a list
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	var data []resources.ContactManagecontactslists 	mr := &mailjet.Request{ 		Resource: "contact", 		ID:       423, // replace with your contact ID here 		Action:   "managecontactslists", 	} 	fmr := &mailjet.FullRequest{ 		Info: mr, 		Payload: &resources.ContactManagecontactslists{ 			ContactsLists: []resources.ContactsListAction{ // replace with your contact lists here 				{ 					ListID: 432, 					Action: "addnoforce", 				}, 				{ 					ListID: 553, 					Action: "addforce", 				}, 			}, 		}, 	} 	err := mailjetClient.Post(fmr, &data) 	if err != nil { 		fmt.Println(err) 	} 	fmt.Printf("Data array: %+v\n", data) }

GET request

Retrieve all objects

// Retrieve all contacts:
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	var data []resources.Contact 	, , err := mailjetClient.List("contact", &data) 	if err != nil { 		fmt.Println(err) 	} 	fmt.Printf("Data array: %+v\n", data) }

Use filtering

// Retrieve all contacts that are not in the campaign exclusion list:
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	var data []resources.Contact 	, , err := mailjetClient.List("contact", &data, mailjet.Filter("IsExcludedFromCampaigns", "false")) 	if err != nil { 		fmt.Println(err) 	} 	fmt.Printf("Data array: %+v\n", data) }

Retrieve a single object

// Retrieve a specific contact ID:
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	var data []resources.Contact 	mr := &mailjet.Request{ 		Resource: "contact", 		ID:       5234, // replace with your contact ID here 	} 	err := mailjetClient.Get(mr, &data) 	if err != nil { 		fmt.Println(err) 	} 	fmt.Printf("Data array: %+v\n", data) }

PUT request

A PUT request in the Mailjet API will work as a PATCH request - the update will affect only the specified properties. The other properties of an existing resource will neither be modified, nor deleted. It also means that all non-mandatory properties can be omitted from your payload.

Here's an example of a PUT request:

// Update the contact properties for a contact:
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" 	"github.com/mailjet/mailjet-apiv3-go/v4/resources" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE")) 	mr := &mailjet.Request{ 		Resource: "contactdata", 		ID:       325, // replace with your contact ID here 		//AltID: "user1@example.com", // alternatively you can use contact's email 	} 	fmr := &mailjet.FullRequest{ 		Info: mr, 		Payload: &resources.Contactdata{ 			Data: resources.KeyValueList{ 				{ 					"Name":  "name", 					"Value": "John", 				}, 				{ 					"Name":  "country", 					"Value": "Canada", 				}, 			}, 		}, 	} 	err := mailjetClient.Put(fmr, nil) 	if err != nil { 		fmt.Println(err) 	} }

DELETE request

Upon a successful DELETE request the response will not include a response body, but only a 204 No Content response code.

Here's an example of a DELETE request:

// Delete an email template:
package main
import ( 	"fmt" 	"os"
"github.com/mailjet/mailjet-apiv3-go/v4" )
func main() { 	mailjetClient := mailjet.NewMailjetClient(os.Getenv("MJAPIKEYPUBLIC"), os.Getenv("MJAPIKEYPRIVATE"))
mr := &mailjet.Request{ 		Resource: "template", 		ID:       423, // replace with your template ID here 	}
err := mailjetClient.Delete(mr) 	if err != nil { 		fmt.Println(err) 	} }

Contribute

Mailjet loves developers. You can be part of this project!

This wrapper is a great introduction to the open source world, check out the code!

Feel free to ask anything, and contribute:

• Fork the project.
• Create a new branch.
• Implement your feature or bug fix.
• Add documentation to it.
• Commit, push, open a pull request and voilà.