Zur Dokumentation springen
Entwicklerv1
CherryMail-Entwicklerdokumentation durchsuchen
Entwickler /API-Referenz/ E-Mail-Postfächer
E-Mail-Postfächer

E-Mail-Postfach erstellen

Erstelle ein E-Mail-Postfach auf einer verifizierten Domain.

POST/api/v1/mailboxes/
Berechtigung write

Request-Header

Idempotency-Keystringerforderlich

Ein eindeutiger Schlüssel für diese beabsichtigte Aktion. Verwende ihn nur mit denselben Anfrageeingaben erneut.

Maximal 128 Zeichen

Anfragetext

Sende JSON mit Content-Type: application/json.

domainintegererforderlich

Domainname beim Reservieren einer Domain; Domain-ID beim Erstellen eines E-Mail-Postfachs oder einer Alias-Adresse.

localPartstringerforderlich

Der Teil der E-Mail-Adresse vor dem @-Zeichen.

Maximal 64 Zeichen

displayNamestring

Der Anzeigename des E-Mail-Postfachs.

Maximal 120 Zeichen

quotaMbinteger

Optionales Speicherlimit in MiB, innerhalb der Kontolimits.

Antworten

200Erfolgreich

Dauerhafter Vorgangsbeleg mit dem Ergebnis dieses Endpunkts. Ausstehende Bereitstellung und SMTP-Annahme sind nicht gleichbedeutend mit der Bereitschaft der Ressource oder der Zustellung an den Empfänger.

400Ungültige Anfrage

Ungültige Eingabe oder fehlender Idempotenzschlüssel.

401Nicht authentifiziert

Fehlender, abgelaufener oder widerrufener Bearer-Token.

403Verboten

Falscher Verwendungszweck der Anmeldedaten, unzureichender Berechtigungsumfang oder fehlende Freigabe für das E-Mail-Postfach.

404Nicht gefunden

Ressource oder Nachricht nicht gefunden oder für diese Integration nicht verfügbar.

409Konflikt

Ressourcenkonflikt, veralteter Nachrichtenverweis, mehrdeutige Übermittlung oder Idempotenzkonflikt.

413Zu groß

Anfrage oder Nachricht überschreitet die unterstützte Größe.

429Ratenbegrenzung erreicht

Ratenlimit erreicht. Warte vor einem erneuten Versuch die unter Retry-After angegebene Zeit ab.

500Interner Serverfehler

Unerwarteter Serverfehler. Wende dich mit der Anfrage-ID an den Support. Prüfe unklare Schreibvorgänge, bevor du es erneut versuchst.

503Dienst nicht verfügbar

Integrationen deaktiviert oder ein vorgelagerter Dienst nicht verfügbar.

Unter Limits und Fehler findest du Informationen zur Wiederholungsbehandlung und zum Fehlerobjekt.