Official SDKs

Overview

EuroMail publishes official, typed SDKs for four languages. Each wraps the same REST API. Authentication, retries, and JSON handling are done for you, so you call methods instead of building HTTP requests. You can always fall back to plain HTTP (see Sending Emails) if your language is not listed.

All SDKs read your API key. Keep it in an environment variable, never in source.

TypeScript / JavaScript

• Package: @euromail/sdk on npm
• Source: github.com/kalle-works/euromail-typescript

npm install @euromail/sdk

import { EuroMail } from "@euromail/sdk";

const client = new EuroMail({ apiKey: process.env.EUROMAIL_API_KEY! });

await client.emails.send({
  from: "[email protected]",
  to: "[email protected]",
  subject: "Welcome aboard",
  html_body: "<h1>Welcome!</h1>",
  text_body: "Welcome!",
});

Python

• Package: euromail on PyPI
• Source: github.com/kalle-works/euromail-python

pip install euromail

import os
from euromail import EuroMail

client = EuroMail(api_key=os.environ["EUROMAIL_API_KEY"])

client.emails.send(
    from_="[email protected]",
    to="[email protected]",
    subject="Welcome aboard",
    html_body="<h1>Welcome!</h1>",
    text_body="Welcome!",
)

Rust

• Crate: euromail on crates.io
• Source: github.com/kalle-works/euromail-rust

cargo add euromail

use euromail::Client;

let client = Client::from_env()?; // reads EUROMAIL_API_KEY

client.emails().send(
    euromail::SendEmail::new("[email protected]", "[email protected]", "Welcome aboard")
        .html_body("<h1>Welcome!</h1>")
        .text_body("Welcome!"),
).await?;

Go

• Source: github.com/kalle-works/euromail-go

go get github.com/kalle-works/euromail-go

client := euromail.NewClient(os.Getenv("EUROMAIL_API_KEY"))

_, err := client.Emails.Send(ctx, &euromail.SendEmail{
    From:     "[email protected]",
    To:       "[email protected]",
    Subject:  "Welcome aboard",
    HTMLBody: "<h1>Welcome!</h1>",
    TextBody: "Welcome!",
})

Choosing between an SDK and raw HTTP

The SDKs are the fastest path and handle the fiddly parts (auth headers, JSON, typed responses). Use raw HTTP when you need a language without an SDK, want zero dependencies, or are calling from a shell script or serverless edge runtime. The Sending Emails guide shows the equivalent curl for every operation.

For AI agents and assistants, also see the MCP server, which exposes EuroMail as tools an LLM can call directly.