SDKs

Use the official SDK repository for server-side integrations. All three clients cover sending, receiving, inboxes, domains and health, webhooks, suppressions, API keys and permissions. The SDKs are MIT licensed and generated from the same public OpenAPI contract as this reference. Dashboard billing and OAuth consent are not API-key operations.

JavaScript/TypeScript is available on npm. Python is available as a GitHub Release wheel while PyPI setup is completed. Go uses a versioned module tag. Pin versions and test upgrades.

JavaScript / TypeScript
Python
Go

npm install moonemail@0.1.1

import { Moonemail } from 'moonemail';

const email = new Moonemail(process.env.MOONEMAIL_API_KEY!);
const sent = await email.emails.send({
  from: 'Acme <hello@your-verified-domain.com>',
  to: ['recipient@example.com'],
  subject: 'Your receipt',
  text: 'Thanks for your order.',
}, { idempotencyKey: 'order-123-receipt' });

Node.js 22+. TypeScript usage and errors.

pip install https://github.com/halyard-labs/moonemail-sdks/releases/download/v0.1.1/moonemail-0.1.1-py3-none-any.whl

import os
from moonemail import Moonemail

with Moonemail(os.environ['MOONEMAIL_API_KEY']) as email:
    sent = email.emails.send({
        'from': 'Acme <hello@your-verified-domain.com>',
        'to': ['recipient@example.com'],
        'subject': 'Your receipt',
        'text': 'Thanks for your order.',
    }, idempotency_key='order-123-receipt')

Python 3.10+. Python usage and errors.

go get github.com/halyard-labs/moonemail-sdks/go@v0.1.1

email, err := moonemail.New(os.Getenv("MOONEMAIL_API_KEY"))
if err != nil { return err }

Go 1.23+. Complete Go example.

Keep keys on your server. Clients do not automatically retry sends; reuse the same idempotency key and payload when retrying, and respect rate-limit responses. These clients do not add unsupported features such as campaigns or SMTP.

Versions and updates

New API contract versions trigger SDK releases. SDK fixes can also ship as patch releases, so the SDK and API version numbers may differ. The release workflow regenerates and tests all three clients before publishing. See release notes for changes and the public contract for the schemas behind the clients. Your installed package stays pinned until you choose to upgrade.

Get started

Build your integration

Versions and updates

​Versions and updates

Versions and updates