Aller à la documentation
API

Créer une adresse

Crée une adresse sur le domaine. Elle reçoit dès que le domaine reçoit, et on peut envoyer depuis elle dès que le domaine peut envoyer.

POST/domains/{id}/addresses

Exécute le véritable appel sur votre espace de travail, avec votre propre clé.

POST /domains/{id}/addresses

Crée une adresse sur le domaine. Elle reçoit dès que le domaine reçoit, et on peut envoyer depuis elle dès que le domaine peut envoyer.

La requête

Paramètres

localPartstringobligatoire
La partie avant le `@`, de 1 à 64 caractères, en minuscules. `*` est la façon d'écrire le catch-all et ne peut pas être une adresse à part entière.
labelstring | null
Un nom pour l'adresse dans l'application, 120 caractères au plus.

Exemple

Nécessite domains:write. Une clé limitée à certaines adresses ou certains domaines doit détenir le domaine en entier.

curl
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "localPart": "billing", "label": "Invoices" }'
Réponse
{  "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"}

Créer une adresse qui a été supprimée la rétablit, activée. Créer une adresse qui existe déjà la réactive et la renvoie, et ne change son libellé que si vous en envoyez un.

Avec le catch-all activé, une nouvelle adresse démarre avec la signature et les réglages du catch-all.

Une adresse réservée à un compte répond 409 address_reserved, et un espace de travail qui a atteint sa limite d'adresses répond 422 workspace_limit_reached.

Votre boîte de réception,
à vos conditions.

L’infrastructure e-mail pour les entreprises, l’IA, les agents et le courrier personnel. Conçue pour l’échelle, la confidentialité et le contrôle. Tout ce que l’e-mail aurait dû avoir dès le premier jour.

OpenEmail

L’infrastructure e-mail pour les entreprises, l’IA, les agents et le courrier personnel. Conçue pour l’échelle, la confidentialité et le contrôle. Tout ce que l’e-mail aurait dû avoir dès le premier jour.

© 2026 OpenEmail. Tous droits réservés.