Ontwikkelaars → Email
Beheer de mail van uw domeinen vanuit code: mailboxen op betaalde e-mailhosting, gratis doorsturen voor domeinen die bij NameOcean zijn geregistreerd, en inkomende mail die als JSON naar uw app wordt gepost.
Maak een API-sleutel aan met email:read, en email:write om wijzigingen aan te brengen. Elk endpoint staat in de API-referentie en het OpenAPI-bestand. Het kopen, upgraden en verlengen van een mailpakket kost accounttegoed en gebeurt in het dashboard.
Het pakket van een maildomein heeft een opslaggrootte die de mailboxen delen. Maakt u een mailbox aan zonder wachtwoord, dan wordt er een gegenereerd; het antwoord is de enige keer dat de API het teruggeeft.
$ 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} | Mailboxen, aliassen, lijsten en de IMAP/SMTP-instellingen |
| PATCH /email/domains/{domain}/mailboxes/{username} | Naam of quotum wijzigen |
| POST /email/domains/{domain}/mailboxes/{username}/password | Een wachtwoord instellen of laten genereren |
| POST /email/domains/{domain}/aliases | Een ander adres afleveren in een mailbox |
| POST /email/domains/{domain}/lists | Een mailinglijst van de mailboxen van het domein |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM en DMARC, live, met de verwachte waarden |
Domeinen die bij NameOcean zijn geregistreerd en onze nameservers gebruiken, kunnen hun mail gratis doorsturen. Bij inschakelen wordt het MX-record aangemaakt; staan er in de zone MX-records van een andere provider, stuur dan replace_mx: true mee om die te verwijderen.
$ 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"}'
Een nieuw doeladres ontvangt een mail met een link en een 6-cijferige code, en mail wordt doorgestuurd zodra de eigenaar bevestigt (via de link, of POST /email/forwarding/targets/{id}/verify met de code). * stuurt elk adres zonder eigen alias door. GET /email/forwarding/{domain}/messages toont de mail van de afgelopen 30 dagen met de status; vastgehouden mail (spam, boven de daglimiet) kan met /release worden doorgestuurd.
In plaats van doorsturen kan een adres elke ontvangen mail als JSON naar uw HTTPS-endpoint posten: berichttekst, headers en bijlagen in base64. Dit is beschikbaar na een korte beoordeling van waarvoor u het gaat gebruiken; vraag het aan op de pagina E-mail doorsturen van een domein.
$ 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"}'
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
}
De handtekening werkt net als bij de accountwebhooks: zie een handtekening verifiëren.
Account-webhooks kunnen zich abonneren op email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled en email.forwarding.disabled (ook verzonden wanneer een domein niet langer in aanmerking komt voor gratis doorsturen, met de reden).
$ 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
Elk commando ondersteunt --json. Installatie en alle commando's: CLI.
Via MCP kan een assistent uw maildomeinen weergeven, de DNS ervan controleren, mailboxen en aliassen aanmaken en doorsturen inschakelen. Mailboxwachtwoorden worden nooit naar de AI verzonden: u bekijkt ze in het dashboard.