Email Account

Email Account ist ein SMTP-Absender, den Sie in einem Space registrieren. Es ist eine Ressource, die die Serveradresse zum Versenden von E-Mails, die Anmeldedaten und die Absenderadresse zu einer Einheit zusammenfasst und speichert. Wenn das EmailSend-Statement eines Script ausgeführt wird, wird die eigentliche E-Mail über dieses Email Account versendet. Um zum Beispiel in einem Modeladen-Shop bei jeder eingehenden Bestellung eine Bestätigungs-E-Mail zu versenden, registrieren Sie zunächst das Email Account für den Versand und lassen das Script darauf verweisen.

Email Account ist eine von der CMA verwaltete, dem Space untergeordnete Ressource, und der Pfad orientiert sich an /spaces/{spaceId}/email-accounts. Es gibt kein Konzept einer Veröffentlichung (publish). Ohne Statuswert oder Veröffentlichungsschritt lässt es sich unmittelbar nach dem Erstellen zum Versand nutzen. Dafür wird unten behandelt, dass das Erstellen kein harmloser, lesender Vorgang ist, sondern ein Vorgang, der tatsächlich eine E-Mail versendet, um die Konfiguration zu überprüfen, und dass sich die Verbindungsdaten (endpoint, username, password) nach dem einmaligen Erstellen nicht mehr ändern lassen.

Ressourcenstruktur

Das Folgende ist die Antwort beim Erstellen eines Email Account. In sys (Systemeigenschaften) stehen Kennung und Version, im Rumpf die Absenderkonfiguration (name, endpoint, username, fromAddress, fromName). Das Passwort (password) erscheint an keiner Stelle der Antwort.

{
  "sys": {
    "id": "3trmXRMdKpLc7GfNbyVQeR2WsT9LnU",
    "type": "EmailAccount",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "createdBy": { "sys": { "id": "9dLmQ2pVnRb8sTfWcXd3LhJ7gK", "type": "Refer", "targetType": "User" } },
    "createdAt": "2026-08-04T05:12:44.108Z",
    "updatedBy": { "sys": { "id": "9dLmQ2pVnRb8sTfWcXd3LhJ7gK", "type": "Refer", "targetType": "User" } },
    "updatedAt": "2026-08-04T05:12:44.108Z",
    "version": 1
  },
  "name": "Bestellbenachrichtigung senden",
  "endpoint": {
    "host": "smtp.gmail.com",
    "port": 587,
    "security": "StartTls"
  },
  "username": "orders@example-shop.com",
  "fromAddress": "orders@example-shop.com",
  "fromName": "Modeladen Bestellungen"
}

Wichtige Schlüssel:

• sys.id: Die eindeutige Kennung des Email Account. Kommt in {emailAccountId} der Pfade für Einzelabruf, Änderung und Löschung.
• sys.version: Die Ressourcenversion. Beginnt bei 1 und erhöht sich bei jeder Änderung. Bei einer Änderungsanfrage senden Sie diesen Wert im Header X-Weegloo-Version mit (siehe Status und Einschränkungen unten).
• name: Das in der Konsole sichtbare Label (z. B. Bestellbenachrichtigung senden). Wird nicht für den Versand verwendet und ist nicht der From-Anzeigename. Es ist lediglich ein Name, um mehrere Absender zu unterscheiden.
• endpoint: Der SMTP-Server, zu dem verbunden wird. Besteht aus den drei Werten host, port, security.
• username: Der SMTP-Anmeldebenutzername. Unterscheidet sich je Anbieter. Er kann die E-Mail-Adresse selbst sein, aber auch eine vom Versanddienst festgelegte feste Zeichenfolge oder eine domänenweite Anmeldung.
• fromAddress: Die Absenderadresse. Wird zugleich als Rückläuferadresse des Umschlags (MAIL FROM) und als die dem Empfänger sichtbare From-Adresse verwendet.
• fromName: Der im From-Header sichtbare Anzeigename (optional). Fehlt er, erscheint nur die Adresse.

Das Passwort (password) ist ein reiner Schreibwert, der nur im Rumpf der Erstellungsanfrage gesendet wird, und kommt daher weder in der obigen Antwort noch später in einem Abruf oder einer Liste zurück. username erscheint in der Abrufantwort unverändert so, wie Sie ihn eingegeben haben.

Systemeigenschaften (sys)

Jedes Email Account führt die gemeinsamen Systemeigenschaften im sys-Objekt. space, createdBy und updatedBy liegen in der Refer-Form ({ "sys": { "id", "type": "Refer", "targetType" } }) vor.

Rumpfeigenschaften:

Nur im Rumpf der Erstellungsanfrage:

Absenderdaten und Verbindungsdaten

Die Werte eines Email Account teilen sich in zwei Arten. Diese Unterscheidung bestimmt, was sich ändern lässt.

• Verbindungsdaten — endpoint, username, password. Nach dem Erstellen nicht mehr änderbar. Wenn Sie den Versandserver wechseln oder die Anmeldedaten rotieren, erstellen Sie ein neues Email Account und löschen das bisherige. Da sich das Passwort, wie oben erläutert, nicht erneut lesen lässt, behandeln Sie einen Verlust nicht als Zurücksetzen, sondern als Neuerstellung.
• Absenderdaten — name, fromAddress, fromName. Auch nach dem Erstellen per Änderung (PUT) änderbar. Wird verwendet, um das Label aufzuräumen oder die Absenderadresse bzw. den Anzeigenamen zu ändern; die Verbindungsdaten bleiben dabei unverändert.

Beim Erstellen wird tatsächlich eine E-Mail versendet

Das Erstellen eines Email Account ist kein Vorgang, der die Konfiguration nur speichert. Vor dem Speichern verbindet sich der Server tatsächlich mit den eingegebenen endpoint, username und password und versendet eine Test-E-Mail. Das Versandziel ist fromAddress; ist username eine andere Adresse, kann auch diese Adresse einbezogen werden.

• Die Ressource wird nur gespeichert, wenn der Versand erfolgreich ist.
• Weist der Server in irgendeinem Schritt von Verbindung, Authentifizierung oder Versand zurück, schlägt es fehl, ohne dass irgendetwas erstellt wird, und die vom Server zurückgegebene Fehlerursache wird in der Antwort mitgeliefert.

Beachten Sie daher, dass bei wiederholtem Erstellen mit falschen Werten jedes Mal ein tatsächlicher Versand versucht wird.

Status und Einschränkungen

Die Wertbeschränkungen, die beim Erstellen und Ändern gelten.

Regeln zu Verhalten und Berechtigungen:

• Die Verbindungsdaten sind unveränderlich. Mit Update (PUT) lassen sich nur name, fromAddress und fromName ändern. Um endpoint, username oder password zu ändern, erstellen Sie ein neues und löschen das bisherige.
• Für eine Änderung ist die Version erforderlich. In der Update-Anfrage senden Sie den aktuellen sys.version-Wert im Header X-Weegloo-Version. Ist der Wert nicht aktuell, wird sie wegen eines Versionskonflikts abgelehnt. Rufen Sie in diesem Fall die Ressource erneut ab und versuchen Sie es mit der aktuellen sys.version erneut.
• Das Passwort lässt sich nicht erneut lesen. Da es weder in einem Abruf noch in einer Liste erscheint, behandeln Sie einen Verlust nicht als Zurücksetzen, sondern als Neuerstellung.
• Je nach Tarif stehen unterschiedliche SMTP-Server zur Verfügung. Voreingestellte Anbieterhosts (Gmail, Naver, Resend, Brevo) lassen sich auch in niedrigeren Tarifen registrieren. Ein beliebiger (selbst gehosteter) Host, der nicht voreingestellt ist, lässt sich nur nutzen, wenn ein Zahlungsmittel hinterlegt ist. Die tarifabhängige Richtlinie finden Sie unter Tarife.

API

Die Basis-URL aller folgenden Endpunkte ist https://cma.weegloo.com/v1, und im Authorization-Header ist ein Bearer-Token erforderlich, das die CMA authentifiziert. Für die Änderung (PUT) ist zusätzlich der Header X-Weegloo-Version erforderlich.

Verwandte Dokumente

• Script: Sendet mit dem EmailSend-Statement über dieses Email Account E-Mails.
• SpaceRole: Die Rolle, die die Zugriffsberechtigungen für die Ressourcen dieses Space definiert.
• Tarife: Die Nutzungsrichtlinie für voreingestellte Anbieterhosts und beliebige (selbst gehostete) SMTP-Hosts.