Desarrolladores → Email
Gestione el correo de sus dominios desde código: buzones en el alojamiento de correo de pago, reenvío gratuito para dominios registrados en NameOcean y correo entrante enviado a su aplicación como JSON.
Cree una clave de API con email:read, y email:write para realizar cambios. Todos los endpoints están en la referencia de la API y en el archivo OpenAPI. La compra, mejora y renovación de un plan de correo consume saldo de la cuenta y se realiza desde el panel.
El plan de un dominio de correo tiene un espacio de almacenamiento que comparten sus buzones. Si crea un buzón sin contraseña, se genera una; la respuesta es la única ocasión en que la API la devuelve.
$ 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} | Buzones, alias, listas y la configuración IMAP/SMTP |
| PATCH /email/domains/{domain}/mailboxes/{username} | Cambiar el nombre o la cuota |
| POST /email/domains/{domain}/mailboxes/{username}/password | Establecer una contraseña o generar una |
| POST /email/domains/{domain}/aliases | Entregar otra dirección a un buzón |
| POST /email/domains/{domain}/lists | Una lista de correo con los buzones del dominio |
| GET /email/domains/{domain}/dns-check | NS, MX, SPF, DKIM y DMARC, en tiempo real, con los valores esperados |
Los dominios registrados en NameOcean que usan nuestros servidores de nombres pueden reenviar su correo gratis. Al activarlo se escribe el registro MX; si la zona tiene registros MX de otro proveedor, envíe replace_mx: true para eliminarlos.
$ 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"}'
Cada nueva dirección de destino recibe un correo con un enlace y un código de 6 dígitos, y el correo se reenvía en cuanto su titular lo confirma (con el enlace o con POST /email/forwarding/targets/{id}/verify y el código). * reenvía todas las direcciones que no tienen alias propio. GET /email/forwarding/{domain}/messages muestra el correo de los últimos 30 días con su estado; el correo retenido (spam, por encima del límite diario) puede reenviarse con /release.
En lugar de reenviarlo, una dirección puede enviar cada correo que recibe a su endpoint HTTPS como JSON: cuerpos, cabeceras y adjuntos en base64. Está disponible tras una breve revisión del uso que le dará; solicítelo en la página de Reenvío de correo de un dominio.
$ 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
}
La firma funciona igual que en los webhooks de la cuenta: consulte cómo verificar una firma.
Los webhooks de la cuenta pueden suscribirse a email.*: email.mailbox.created, email.mailbox.deleted, email.forwarding.enabled y email.forwarding.disabled (también se envía cuando un dominio deja de cumplir los requisitos del reenvío gratuito, con el motivo).
$ 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
Todos los comandos admiten --json. Instalación y todos los comandos: CLI.
A través de MCP, un asistente puede listar sus dominios de correo, comprobar su DNS, crear buzones y alias, y activar el reenvío. Las contraseñas de los buzones nunca se envían a la IA: usted las consulta en el panel.