Groundmail SDKs

Official clients for the Groundmail transactional email API:
Python, Go, Ruby, PHP, Laravel and Symfony Mailer. Node.js is on npm as groundmail.

Docs · Get a free account · groundmail.dev

Python

from groundmail import Groundmail

tx = Groundmail("gm_your_key_here")

result = tx.emails.send(
    from_="you@yourdomain.com",
    to="user@example.com",
    subject="Hello",
    html="<p>It works.</p>",
)

print(result["id"], result["status"])

Go

client, err := groundmail.New("gm_your_key_here")
if err != nil {
	log.Fatal(err)
}

result, err := client.Emails.Send(map[string]any{
	"from":    "you@yourdomain.com",
	"to":      "user@example.com",
	"subject": "Hello",
	"html":    "<p>It works.</p>",
})

Ruby

require "groundmail"

tx = Groundmail::Client.new("gm_your_key_here")

result = tx.emails.send(
  from: "you@yourdomain.com",
  to: "user@example.com",
  subject: "Hello",
  html: "<p>It works.</p>"
)

Each folder has its own README with framework setup, errors and retries.

Found a bug or want something added? Open an issue. These SDKs are published here on each release, so we port fixes rather than merging pull requests directly.

• Our own mail servers and IP space. Your password resets and receipts don't share a pool with bulk marketing senders.
• Transactional email only. No newsletters or cold outreach on the platform, which keeps the sending reputation clean.
• Start free. Free covers 3,000 emails a month. After that it's pay as you go: $0.70 per 1,000, less as you grow. Pricing
• Built for code and for agents. REST API, SMTP, SDKs for Node, Python, Go, PHP and Ruby, a CLI, and an MCP server for Claude, ChatGPT and Cursor.

Website · Docs · Pricing · Sign up free