Ir a la documentación
API

Crear una dirección

Crea una dirección en el dominio. Recibe en cuanto el dominio recibe, y se puede enviar desde ella en cuanto el dominio puede enviar.

POST/domains/{id}/addresses

Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.

POST /domains/{id}/addresses

Crea una dirección en el dominio. Recibe en cuanto el dominio recibe, y se puede enviar desde ella en cuanto el dominio puede enviar.

La solicitud

Parámetros

localPartstringobligatorio
La parte anterior a la `@`, de 1 a 64 caracteres, en minúsculas. `*` es como se escribe el catch-all y no puede ser una dirección por sí misma.
labelstring | null
Un nombre para la dirección en la app, de 120 caracteres como máximo.

Ejemplo

Necesita domains:write. Una clave limitada a determinadas direcciones o dominios necesita tener el dominio entero.

curl
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "localPart": "billing", "label": "Invoices" }'
Respuesta
{  "object": "address",  "id": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18",  "domainId": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",  "address": "[email protected]",  "localPart": "billing",  "label": "Invoices",  "enabled": true,  "lastReceivedAt": null,  "createdAt": "2026-09-25T10:00:00.000Z",  "updatedAt": "2026-09-25T10:00:00.000Z"}

Crear una dirección que se eliminó la recupera, activada. Crear una que ya existe la vuelve a activar y la devuelve, y solo cambia su etiqueta cuando envías una.

Con el catch-all activado, una dirección nueva empieza con la firma y los ajustes que tiene el catch-all.

Una dirección reservada para una cuenta responde 409 address_reserved, y un espacio de trabajo en su límite de direcciones responde 422 workspace_limit_reached.

Tu bandeja de entrada,
en tus propios términos.

Infraestructura de correo para empresas, IA, agentes y correo personal. Creada para escalar, con privacidad y control. Todo lo que el correo debería haber tenido desde el primer día.

OpenEmail

Infraestructura de correo para empresas, IA, agentes y correo personal. Creada para escalar, con privacidad y control. Todo lo que el correo debería haber tenido desde el primer día.

© 2026 OpenEmail. Todos los derechos reservados.