Entwickler → Email

Email API

Verwalten Sie die E-Mails Ihrer Domains per Code: Postfächer mit kostenpflichtigem E-Mail-Hosting, kostenlose Weiterleitung für bei NameOcean registrierte Domains und eingehende E-Mails, die als JSON an Ihre App gesendet werden.

Bevor Sie beginnen

Erstellen Sie einen API-Schlüssel mit email:read sowie email:write, um Änderungen vorzunehmen. Alle Endpunkte finden Sie in der API-Referenz und in der OpenAPI-Datei. Kauf, Upgrade und Verlängerung eines Mail-Tarifs werden mit Kontoguthaben bezahlt und im Dashboard erledigt.

Postfächer

Der Tarif einer Mail-Domain hat eine Speichergröße, die sich ihre Postfächer teilen. Wenn Sie ein Postfach ohne Passwort erstellen, wird eines generiert; die Antwort ist das einzige Mal, dass die API es zurückgibt.

curl

$ curl -X POST https://nameocean.net/api/v1/email/domains/example.com/mailboxes \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \
    -d '{"username": "info", "full_name": "Info", "quota_gb": 2}'

{"address": "info@example.com", "username": "info", "full_name": "Info", "quota_gb": 2,
 "used_gb": "0.00", "aliases": [], "password": "Qm7…"}

GET /email/domains/{domain}	Postfächer, Aliasse, Listen und die IMAP/SMTP-Einstellungen
PATCH /email/domains/{domain}/mailboxes/{username}	Name oder Kontingent ändern
POST /email/domains/{domain}/mailboxes/{username}/password	Passwort festlegen oder generieren
POST /email/domains/{domain}/aliases	Eine weitere Adresse an ein Postfach zustellen
POST /email/domains/{domain}/lists	Eine Mailingliste aus den Postfächern der Domain
GET /email/domains/{domain}/dns-check	NS, MX, SPF, DKIM und DMARC live, mit den erwarteten Werten

Kostenlose Weiterleitung

Bei NameOcean registrierte Domains, die unsere Nameserver verwenden, können ihre E-Mails kostenlos weiterleiten. Beim Aktivieren wird der MX-Eintrag geschrieben; enthält die Zone MX-Einträge eines anderen Anbieters, senden Sie replace_mx: true, um sie zu entfernen.

curl

$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY"
$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/aliases \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \
    -d '{"localpart": "hello", "to": "me@gmail.com"}'

Eine neue Zieladresse erhält eine E-Mail mit einem Link und einem 6-stelligen Code. E-Mails werden weitergeleitet, sobald der Inhaber bestätigt (über den Link oder POST /email/forwarding/targets/{id}/verify mit dem Code). * leitet jede Adresse ohne eigenen Alias weiter. GET /email/forwarding/{domain}/messages listet die E-Mails der letzten 30 Tage mit ihrem Status auf; zurückgehaltene E-Mails (Spam, über dem Tageslimit) können mit /release weitergeleitet werden.

Eingehende E-Mails an Webhook

Statt weiterzuleiten, kann eine Adresse jede empfangene E-Mail als JSON an Ihren HTTPS-Endpunkt senden: Inhalte, Header und Anhänge in base64. Die Funktion wird nach einer kurzen Prüfung Ihres Verwendungszwecks freigeschaltet; fragen Sie auf der Seite „E-Mail-Weiterleitung“ einer Domain an.

curl

$ curl -X POST https://nameocean.net/api/v1/email/forwarding/example.com/webhooks \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \
    -d '{"localpart": "inbound", "url": "https://example.com/hooks/mail"}'

POST https://example.com/hooks/mail

X-NameOcean-Event: email.received
X-NameOcean-Signature: t=1794300000,v1=5f2b…

{
  "id": "6f1c2a4e-8b3d-4f5a-9c7e-1d2b3a4c5e6f",
  "event": "email.received",
  "envelope": {"from": "alice@example.org", "to": "inbound@example.com"},
  "from": "Alice <alice@example.org>",
  "subject": "Order 1042",
  "text": "Hi…",
  "html": "<p>Hi…</p>",
  "headers": [["From", "Alice <alice@example.org>"], …],
  "attachments": [{"filename": "invoice.pdf", "content_type": "application/pdf", "size": 48211,
                   "content_base64": "JVBERi0…"}],
  "spam_score": 0.4,
  "size": 66120
}

Die Signatur funktioniert wie bei den Konto-Webhooks: siehe Signatur überprüfen.

Ereignisse

Konto-Webhooks können email.* abonnieren: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled und email.forwarding.disabled (wird auch gesendet, wenn eine Domain die Voraussetzungen für die kostenlose Weiterleitung nicht mehr erfüllt, mit Angabe des Grundes).

Im Terminal

nameocean

$ nameocean email mailboxes add example.com info --name "Info"
$ nameocean email aliases add example.com sales info
$ nameocean email check example.com
$ nameocean email forwards on example.com
$ nameocean email forwards add example.com hello me@gmail.com
$ nameocean email inbound add example.com support https://example.com/hooks/mail

Jeder Befehl akzeptiert --json. Installation und alle Befehle: CLI.

Über Ihre KI

Über MCP kann ein Assistent Ihre Mail-Domains auflisten, deren DNS prüfen, Postfächer und Aliasse anlegen und die Weiterleitung aktivieren. Postfach-Passwörter werden niemals an die KI übermittelt: Sie sehen sie im Dashboard ein.