Eine Adresse anlegen
Legt eine Adresse auf der Domain an. Sie empfängt, sobald die Domain empfängt, und von ihr kann gesendet werden, sobald die Domain senden kann.
Führt den echten Aufruf gegen Ihren Workspace aus, mit Ihrem eigenen Schlüssel.
POST /domains/{id}/addresses
Legt eine Adresse auf der Domain an. Sie empfängt, sobald die Domain empfängt, und von ihr kann gesendet werden, sobald die Domain senden kann.
Die Anfrage
Parameter
localPartstringerforderlich- Der Teil vor dem `@`, 1 bis 64 Zeichen, kleingeschrieben. `*` ist die Schreibweise des catch-all und kann keine eigene Adresse sein.
labelstring | null- Ein Name für die Adresse in der App, höchstens 120 Zeichen.
Beispiel
Erfordert domains:write. Ein Key, der auf bestimmte Adressen oder Domains beschränkt ist, muss die ganze Domain halten.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses" -H "$AUTH" -H "Content-Type: application/json" \ -d '{ "localPart": "billing", "label": "Invoices" }'{ "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"}Eine entfernte Adresse erneut anzulegen holt sie aktiviert zurück. Eine bereits bestehende anzulegen aktiviert sie wieder und gibt sie zurück, und ihr Label ändert sich nur, wenn Sie eines senden.
Mit aktiviertem catch-all startet eine neue Adresse mit der Signatur und den Einstellungen, die der catch-all hat.
Eine für ein Konto reservierte Adresse antwortet mit 409 address_reserved, und ein Workspace an seinem Adresslimit antwortet mit 422 workspace_limit_reached.