Eine Adresse weiterleiten
Wohin die Mail einer Adresse außer in ihr Postfach geht. Jedes Ziel bestätigt per E-Mail, bevor es etwas empfängt.
Führt jeden der 5 Aufrufe in Ihrem Workspace aus.
GET /domains/{id}/addresses/{addressId}/forwards
Wohin die Mail einer Adresse außer in ihr Postfach geht. Jedes Ziel bestätigt per E-Mail, bevor es etwas empfängt.
Die Ziele auflisten
Erfordert domains:read. Jedes Ziel der Adresse, das älteste zuerst. destination sagt, ob die Adresse zusätzlich hier eine Kopie behält (mailbox) oder nur weiterleitet (forward), und max ist die Zahl der Ziele, die eine Adresse haben darf.
curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH"{ "object": "list", "address": "[email protected]", "destination": "mailbox", "max": 10, "data": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "live", "confirmedAt": "2026-09-26T08:12:40.000Z", "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": "2026-09-30T16:45:03.000Z", "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ]}status ist live, sobald das Ziel bestätigt hat, dass es die Mail will, pending, solange es nicht geantwortet hat, refused, wenn es abgelehnt hat, und paused, solange es ausgeschaltet ist. Nur ein live-Ziel empfängt etwas.
Ziele hinzufügen
Erfordert domains:write. POST /domains/{id}/addresses/{addressId}/forwards mit { emails }, 1 bis 10 Adressen. Jedes neue Ziel bekommt eine E-Mail mit der Bitte um Bestätigung und beginnt deshalb mit pending.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "emails": ["[email protected]", "[email protected]"] }'{ "object": "address_forwards", "added": [ { "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": true, "status": "pending", "confirmedAt": null, "askedAt": "2026-09-26T08:02:11.000Z", "lastRelayAt": null, "lastError": null, "failures": 0, "createdAt": "2026-09-26T08:02:11.000Z" } ], "skipped": [ { "email": "[email protected]", "reason": "[email protected] is hosted here, so it cannot be a forwarding destination. Share the address with that person instead." } ]}Eine hier gehostete Adresse, eine bereits in der Liste stehende, eine, die eine Schleife bilden würde, eine über dem Limit von 10 und eine, die Mail von diesem Workspace abgelehnt hat, werden mit dem Grund in skipped genannt, und die übrigen werden trotzdem hinzugefügt.
Eine ausgeschaltete Adresse wird mit 409 address_disabled abgelehnt.
Ein Key, der auf bestimmte Adressen oder Domains beschränkt ist, muss die ganze Domain halten, und eine App, die für ein Mitglied handelt, kann nur eine Adresse weiterleiten, die dieses Mitglied erreicht.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.
Ein Ziel pausieren oder einschalten
Erfordert domains:write. PATCH /domains/{id}/addresses/{addressId}/forwards/{forwardId} mit { enabled }. Ein pausiertes Ziel behält seine Bestätigung, zum Wiedereinschalten braucht es also keine neue.
curl -X PATCH "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH" \ -H "Content-Type: application/json" \ -d '{ "enabled": false }'{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "enabled": false, "status": "paused", "destination": "mailbox"}Wird das letzte eingeschaltete Ziel pausiert, behält die Adresse ihre Mail wieder hier, und destination zeigt das an.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.
Ein Ziel entfernen
Erfordert domains:write. DELETE /domains/{id}/addresses/{addressId}/forwards/{forwardId}. An dieses Ziel wird nichts mehr weitergeleitet.
curl -X DELETE "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d" -H "$AUTH"{ "object": "address_forward", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "deleted": true, "destination": "mailbox"}War es das letzte eingeschaltete Ziel, behält die Adresse ihre Mail wieder hier.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.
Ein Ziel erneut um Bestätigung bitten
Erfordert domains:write. POST /domains/{id}/addresses/{addressId}/forwards/{forwardId}/resend sendet die Bestätigungs-E-Mail noch einmal.
curl -X POST "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f/addresses/5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18/forwards/9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d/resend" -H "$AUTH"{ "object": "address_forward_consent", "id": "9a4c1e7b-2d3f-4b5a-8c6d-0e1f2a3b4c5d", "addressId": "5f0c2b7e-8d41-4a6f-b913-7e2a0c4d9b18", "email": "[email protected]", "status": "sent"}status ist sent, already-confirmed, wenn das Ziel nichts braucht, too-soon, wenn die letzte E-Mail gerade erst hinausging, revoked, wenn das Ziel Mail von diesem Workspace abgelehnt hat, oder send-failed, wenn die E-Mail nicht gesendet werden konnte.
Ein OAuth-Zugriffstoken braucht für diesen Aufruf einen Bestätigungscode. Solange die App in den letzten 60 Minuten keinen bestätigt hat, antwortet der Aufruf mit 403 step_up_required und ändert nichts. Ein API-Schlüssel wird nie gefragt. Die Seite Authentifizierung zeigt, wie Sie einen Code anfordern und bestätigen.
Referenz
/domains/{id}/addresses/{addressId}/forwardsVollständige Referenz/domains/{id}/addresses/{addressId}/forwardsVollständige Referenz/domains/{id}/addresses/{addressId}/forwards/{forwardId}Vollständige Referenz/domains/{id}/addresses/{addressId}/forwards/{forwardId}Vollständige Referenz/domains/{id}/addresses/{addressId}/forwards/{forwardId}/resendVollständige Referenz