Overview

Use the official Go SDK to call the MailGlyph API from server-side apps.

Go module: github.com/MailGlyph/mailglyph-go
GitHub repository: MailGlyph Go SDK

Prerequisites

Before you start, make sure you have:

A MailGlyph secret API key (sk_...) for server-side API requests
A MailGlyph public API key (pk_...) for event tracking (/v1/track)
At least one verified sending domain for email sending

Setup links:

Install

go get github.com/MailGlyph/mailglyph-go

Initialize clients (`mailglyph.New`)

Create one SDK client for your secret key and one for your public key:

import (
  "os"

  mailglyph "github.com/MailGlyph/mailglyph-go"
)

secretClient := mailglyph.New(os.Getenv("MAILGLYPH_SECRET_KEY"))
publicClient := mailglyph.New(os.Getenv("MAILGLYPH_PUBLIC_KEY"))

Set environment variables:

export MAILGLYPH_SECRET_KEY="sk_your_secret_key"
export MAILGLYPH_PUBLIC_KEY="pk_your_public_key"

Initialize with alias (`mailglyph.NewClient`)

NewClient is an alias for New.

client := mailglyph.NewClient("sk_your_secret_key")

Configure base URL and timeout (`mailglyph.WithBaseURL`, `mailglyph.WithTimeout`)

Use this when testing against staging or local environments:

import (
  "time"

  mailglyph "github.com/MailGlyph/mailglyph-go"
)

client := mailglyph.New(
  "sk_your_secret_key",
  mailglyph.WithBaseURL("https://api.mailglyph.com"),
  mailglyph.WithTimeout(30*time.Second),
)

Use a custom HTTP client (`mailglyph.WithHTTPClient`)

import (
  "net/http"
  "time"

  mailglyph "github.com/MailGlyph/mailglyph-go"
)

httpClient := &http.Client{Timeout: 20 * time.Second}

client := mailglyph.New(
  "sk_your_secret_key",
  mailglyph.WithHTTPClient(httpClient),
  mailglyph.WithTimeout(10*time.Second),
)

Key usage rules

The Go SDK enforces key restrictions automatically:

pk_* keys can only call Events.Track
sk_* keys can call non-track endpoints, including Events.GetNames and Events.ListNames

Unlike the Node.js SDK, the Go SDK does not expose a keyType property on the client.

Documentation

SDKs

API Reference

Prerequisites

Install

Initialize clients (`mailglyph.New`)

Initialize with alias (`mailglyph.NewClient`)

Configure base URL and timeout (`mailglyph.WithBaseURL`, `mailglyph.WithTimeout`)

Use a custom HTTP client (`mailglyph.WithHTTPClient`)

Key usage rules

Next pages

​Prerequisites

​Install

​Initialize clients (mailglyph.New)

​Initialize with alias (mailglyph.NewClient)

​Configure base URL and timeout (mailglyph.WithBaseURL, mailglyph.WithTimeout)

​Use a custom HTTP client (mailglyph.WithHTTPClient)

​Key usage rules

​Next pages

Prerequisites

Install

Initialize clients (`mailglyph.New`)

Initialize with alias (`mailglyph.NewClient`)

Configure base URL and timeout (`mailglyph.WithBaseURL`, `mailglyph.WithTimeout`)

Use a custom HTTP client (`mailglyph.WithHTTPClient`)

Key usage rules

Next pages