Send email in Go.

Install

Get a key under API keys in the dashboard and verify a sending domain first (how). Then add the library:

1go get github.com/mailtruss/mailtruss-go

Send an email

This sends one message and passes an idempotency key, so repeating the request can never deliver it twice. Reads, deletes and requests with an idempotency key are retried on 429 and 5xx; a send without a key is never retried.

1import mailtruss "github.com/mailtruss/mailtruss-go"
2​
3client := mailtruss.New(os.Getenv("MAILTRUSS_API_KEY"))
4res, err := client.Emails.Send(ctx, mailtruss.SendEmailParams{
5	From: "hello@yourdomain.com", To: []string{"ana@example.com"}, Subject: "Welcome", HTML: "<p>Hi Ana</p>",
6}, &mailtruss.RequestOptions{IdempotencyKey: "welcome-ana"})

More on what you can put in a message (cc, bcc, attachments, tags, templates, scheduling) is under Sending.

Verify webhook signatures

Mailtruss signs every webhook with the Standard Webhooks scheme. Check the signature before you trust a request. Pass the raw body and the request headers.

1event, err := mailtruss.VerifyWebhook(rawBody, r.Header, os.Getenv("MAILTRUSS_WEBHOOK_SECRET"))
2if err != nil {
3	http.Error(w, "invalid signature", http.StatusBadRequest)
4	return
5}

Events, payloads and retries are on the Webhooks page.

Handle errors

Failures are *mailtruss.Error with Name, StatusCode and RequestID. Every error name, with its cause and fix, is in the error catalogue.

Other languages

• Node.js
• Python
• PHP
• Ruby
• Java
• .NET
• curl and HTTP