Zum Inhalt springen
Alpha auf Einladung. Funktionen und Grenzen können sich durch unsere Testerfahrungen ändern.

API-Fehler

Jede Fehlerantwort enthält error.code und error.message; ein 429 wegen eines Versandlimits enthält zusätzlich error.reason und, wenn Warten hilft, Retry-After. Siehe API-Referenz.

Code Status Bedeutung Tun Wiederholen
invalid_request 400 Die Anfrage ist fehlerhaft oder enthält unbekannte Felder. Korrigieren Sie Body oder Abfrage. Nach Korrektur der Anfrage
unauthorized 401 Der API-Schlüssel fehlt, ist falsch, widerrufen oder abgelaufen. Verwenden Sie einen gültigen API-Schlüssel. Nach Korrektur der Anfrage
account_suspended 403 Ihre Organisation ist gesperrt. Wenden Sie sich an den Support. Gelingt nicht
activation_inactive 403 Der Versand ist für diese Installation nicht aktiviert. Wenden Sie sich an den Support. Gelingt nicht
activation_scope_mismatch 403 Der Schlüssel liegt außerhalb des aktivierten Versandbereichs. Verwenden Sie einen Schlüssel für das aktivierte Projekt und den aktivierten Stream. Nach Korrektur der Anfrage
customer_grant_required 403 Dieser Absender hat keine Versandberechtigung. Schließen Sie die Domain-Einrichtung ab oder wenden Sie sich an den Support. Gelingt nicht
customer_price_authority_required 403 Ihr Tarif erlaubt derzeit keinen Versand. Wenden Sie sich an den Support. Gelingt nicht
customer_stream_paused 403 Der Versand auf diesem Stream ist zur Prüfung pausiert. Wenden Sie sich an den Support; diese Pause können Sie nicht selbst aufheben. Gelingt nicht
environment_mismatch 403 Dieser Endpunkt braucht einen Test-API-Schlüssel; ein Live-Schlüssel liest keine erfasste Testmail. Verwenden Sie für /v1/test-Endpunkte einen Test-API-Schlüssel. Nach Korrektur der Anfrage
forbidden 403 Dem API-Schlüssel fehlt das Recht für diese Aktion. Verwenden Sie einen Schlüssel mit dem nötigen Recht. Nach Korrektur der Anfrage
recipient_not_allowlisted 403 Der Empfänger ist in diesem Modus nicht erlaubt. Verwenden Sie einen erlaubten Empfänger. Nach Korrektur der Anfrage
sender_not_activated 403 Der Absender ist nicht die aktivierte Identität. Senden Sie vom aktivierten Absender. Nach Korrektur der Anfrage
not_found 404 Die Ressource existiert nicht oder ist für diesen Schlüssel nicht sichtbar. Prüfen Sie die ID und das Projekt des Schlüssels. Gelingt nicht
idempotency_conflict 409 Der Idempotency-Key wurde bereits mit anderem Inhalt verwendet. Verwenden Sie für neuen Inhalt einen neuen Schlüssel; nutzen Sie einen Schlüssel nie für eine andere Nachricht. Nach Korrektur der Anfrage
too_late_to_cancel 409 Die Nachricht wurde bereits übergeben oder ist abgeschlossen. Lesen Sie den Status der Nachricht; sie lässt sich nicht zurückholen. Gelingt nicht
content_too_large 413 Betreff oder Inhalt überschreiten die Größengrenze. Kürzen Sie den Inhalt. Nach Korrektur der Anfrage
request_too_large 413 Die Anfrage überschreitet die Größengrenze. Senden Sie eine kleinere Anfrage. Nach Korrektur der Anfrage
customer_payload_limit 422 Die Nachricht überschreitet Ihre eingestellte Größengrenze. Senden Sie eine kleinere Nachricht. Nach Korrektur der Anfrage
feature_not_enabled 422 Ein angefragtes Feld wird noch nicht unterstützt. Entfernen Sie das nicht unterstützte Feld. Nach Korrektur der Anfrage
identity_not_authorized 422 Stream oder Absender sind für diesen Schlüssel nicht freigegeben. Verwenden Sie den Stream und Absender, die beim Schlüssel angezeigt werden. Nach Korrektur der Anfrage
invalid_expiry 422 expires_at muss innerhalb der nächsten 24 Stunden liegen. Wählen Sie ein gültiges Ablaufdatum. Nach Korrektur der Anfrage
invalid_mailbox 422 Eine E-Mail-Adresse ist ungültig. Korrigieren Sie die Adresse. Nach Korrektur der Anfrage
invalid_page_size 422 Die angefragte Seitengröße liegt außerhalb des erlaubten Bereichs. Verwenden Sie eine unterstützte Seitengröße. Nach Korrektur der Anfrage
invalid_subject 422 Der Betreff enthält Steuerzeichen. Entfernen Sie die Steuerzeichen. Nach Korrektur der Anfrage
activation_cap_reached 429 Das Versandlimit der Aktivierung wurde erreicht. Wenden Sie sich an den Support. Gelingt nicht
customer_grant_cap_reached 429 Ein Limit der Berechtigung dieses Absenders wurde erreicht; error.reason nennt es. Warten Sie Retry-After ab, wenn vorhanden, und wiederholen Sie mit demselben Idempotency-Key; ohne Retry-After wenden Sie sich an den Support. Gleicher Schlüssel und Body
customer_proof_cap_reached 429 Eines Ihrer Versandlimits wurde erreicht; error.reason nennt es. Warten Sie Retry-After ab, wenn vorhanden, und wiederholen Sie mit demselben Idempotency-Key; ohne Retry-After wenden Sie sich an den Support. Gleicher Schlüssel und Body
customer_shared_cap_reached 429 Der Dienst hat ein gemeinsames Limit erreicht (error.reason service_capacity). Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key. Gleicher Schlüssel und Body
quota_exceeded 429 Ein Versandlimit wurde erreicht. Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key. Gleicher Schlüssel und Body
test_allowance_exceeded 429 Das Testkontingent für erfasste Mails ist erreicht; error.reason nennt die Grenze. Warten Sie Retry-After ab und wiederholen Sie mit demselben Idempotency-Key; erfasste Mails verfallen nach sieben Tagen. Gleicher Schlüssel und Body
service_unavailable 503 Vorübergehend nicht verfügbar, oder das Ergebnis Ihrer Anfrage ist unklar. Wiederholen Sie mit demselben Idempotency-Key und Body; wurde sie angenommen, erhalten Sie das ursprüngliche Ergebnis. Gleicher Schlüssel und Body