Send and receive email from your own domain.

1// npm install mailumi
2import { Mailumi } from 'mailumi';
3 
4const mailumi = new Mailumi(process.env.MAILUMI_API_KEY);
5 
6const { data, error } = await mailumi.emails.send({
7  from: 'Acme <hello@yourdomain.com>',
8  to: 'alex@example.com',
9  subject: 'Welcome aboard',
10  html: '<p>Your account is ready.</p>',
11  text: 'Your account is ready.',
12}, { idempotencyKey: 'welcome-user-123' });
13 
14if (error) throw new Error(error.message);
15console.log(data.id, data.status);

1import os
2import requests
3 
4response = requests.post(
5    "https://mailumi.com/api/v1/emails",
6    headers={
7        "Authorization": f"Bearer {os.environ['MAILUMI_API_KEY']}",
8        "Idempotency-Key": "welcome-user-123",
9    },
10    json={
11        "from": "Acme <hello@yourdomain.com>",
12        "to": "alex@example.com",
13        "subject": "Welcome aboard",
14        "html": "<p>Your account is ready.</p>",
15        "text": "Your account is ready.",
16    },
17    timeout=30,
18)
19email = response.json()
20if not response.ok:
21    raise RuntimeError(email["error"])
22print(email["id"], email["status"])

1<?php
2$ch = curl_init('https://mailumi.com/api/v1/emails');
3curl_setopt_array($ch, [
4    CURLOPT_POST => true,
5    CURLOPT_RETURNTRANSFER => true,
6    CURLOPT_HTTPHEADER => [
7        'Authorization: Bearer ' . getenv('MAILUMI_API_KEY'),
8        'Content-Type: application/json',
9        'Idempotency-Key: welcome-user-123',
10    ],
11    CURLOPT_POSTFIELDS => json_encode([
12        'from' => 'Acme <hello@yourdomain.com>',
13        'to' => 'alex@example.com',
14        'subject' => 'Welcome aboard',
15        'html' => '<p>Your account is ready.</p>',
16        'text' => 'Your account is ready.',
17    ]),
18]);
19$email = json_decode(curl_exec($ch), true);
20if (curl_getinfo($ch, CURLINFO_HTTP_CODE) >= 300) {
21    throw new RuntimeException($email['error']);
22}
23echo $email['id'];

1package main
2 
3import (
4	"bytes"
5	"encoding/json"
6	"fmt"
7	"net/http"
8	"os"
9)
10 
11func main() {
12	body, _ := json.Marshal(map[string]any{
13		"from":    "Acme <hello@yourdomain.com>",
14		"to":      "alex@example.com",
15		"subject": "Welcome aboard",
16		"html":    "<p>Your account is ready.</p>",
17		"text":    "Your account is ready.",
18	})
19	req, _ := http.NewRequest("POST", "https://mailumi.com/api/v1/emails", bytes.NewReader(body))
20	req.Header.Set("Authorization", "Bearer "+os.Getenv("MAILUMI_API_KEY"))
21	req.Header.Set("Content-Type", "application/json")
22	req.Header.Set("Idempotency-Key", "welcome-user-123")
23	res, err := http.DefaultClient.Do(req)
24	if err != nil {
25		panic(err)
26	}
27	defer res.Body.Close()
28	var email map[string]any
29	json.NewDecoder(res.Body).Decode(&email)
30	if res.StatusCode >= 300 {
31		panic(email["error"])
32	}
33	fmt.Println(email["id"], email["status"])
34}