Dedizierte IPs und Pools

Auf geteilter Infrastruktur verlässt Ihre E-Mail IP-Adressen, die Sie mit anderen Kunden teilen. Wir halten diese IPs gesund, aber Ihre Reputation ist trotzdem mit der aller anderen gebündelt. Eine dedizierte IP ist eine Adresse, von der nur Ihre Organisation sendet, sodass Postfachanbieter Ihren Traffic ausschließlich anhand Ihrer eigenen Erfolgsbilanz bewerten. IP-Pools gruppieren dedizierte IPs in routbare Einheiten, und das Feld ip_pool_id beim Versand wählt den Pool für diese Nachricht.

Sie brauchen niemals dedizierte IPs zum Senden. Jede Organisation startet mit dem Shared Bird.com Pool als Standard, sodass E-Mails ab dem ersten Tag fließen, ohne dass Sie etwas konfigurieren müssen. Dedizierte IPs sind ein kostenpflichtiges Add-on, das sich nur bei konstantem Volumen lohnt. Eine wenig genutzte dedizierte IP baut Reputation langsamer auf, als der Shared Pool sie bereits hat, sodass Absender mit geringem Volumen in der Regel besser mit dem Shared Pool fahren. Verbessert eine dedizierte IP die E-Mail-Zustellbarkeit? erklärt, wie Sendevolumen und Reputation diese Entscheidung beeinflussen.

Zwei Dinge, die Sie vor dem Kauf wissen sollten:

Neue IPs durchlaufen ein automatisches Warmup, bevor sie volles Volumen verarbeiten können; Überlauf wird in der Zwischenzeit über den Shared Pool geroutet.
IPs und Pools gehören zu Ihrer Organisation.

Wo Sie sie verwalten

Verwalten Sie Pools und IPs im Dashboard unter Email > IP pools oder mit den bird email ip-pools- und bird email dedicated-ips-CLI-Befehlen. Diese Operationen erfordern Berechtigungen auf Organisationsebene. Die SDKs enthalten keine typisierten Verwaltungsmethoden. Um eine Nachricht über einen Pool zu routen, setzen Sie ip_pool_id wie in Pool beim Versand auswählen beschrieben.

Wenn Ihre Organisation den Pool-Zugriff pro Workspace verwaltet, zeigt ihre Seite Email > IP pools den Bestand der Organisation und die Workspace-Zuweisungen. Eine Workspace-Seite zeigt die Pools, die dieser Workspace verwenden darf. Um diese Zuweisungen zu ändern, benötigen Sie Organisationsberechtigungen. Zugriff auf einen Workspace gewährt keinen Zugriff auf die Pools anderer Workspaces.

Die IP-Pools-Ansicht im Dashboard, mit einem benutzerdefinierten Pool mit einer sich aufwärmenden IP neben dem geschützten Shared Bird.com Pool, der als Standard markiert ist

Eine dedizierte IP kaufen

Kaufen Sie eine IP über den Tab Dedicated IPs oder mit dem CLI:

Codebeispiel

bird email dedicated-ips create --quantity 1 --ip-pool-id ipp_1btmn1nnkd8y6a4jckbkvvt9eh

Beim ersten Kauf können Sie --ip-pool-id weglassen: Wir erstellen Ihren ersten Pool mit dem Namen "Dedicated IPs" und provisionieren die IPs hinein. Sobald Ihre Organisation mindestens einen Pool hat, ist das Flag erforderlich; Sie wählen, wo jede neue IP landet.
Jede IP wird als monatliches Abonnement abgerechnet. Wenn Ihr Wallet-Guthaben den Kauf nicht deckt, meldet die Antwort requires_topup (laden Sie Guthaben auf, um fortzufahren) oder pending_topup (eine Kartenbelastung wird verarbeitet); die IPs werden automatisch provisioniert, sobald die Mittel eingehen.
Käufe sind durch das email_ip_dedicated_max-Kontingent Ihres Plans begrenzt, und Pools durch email_ip_pools_max.

Jede provisionierte IP startet im Status warming und wird automatisch hochgefahren; IP-Warmup beschreibt den Zeitplan und wie Sie es überwachen. Das hostname der IP ist ihr Reverse-DNS-Name (PTR), der Name, mit dem sie sich bei empfangenden Mailservern vorstellt; fügen Sie ihn jeder Allowlist hinzu, die nach dem sendenden Hostnamen filtert.

Der Kauf einer IP ändert nicht Ihren Standard-Pool. Der Shared Pool bleibt der Standard, bis Sie ihn explizit umstellen, denn die Weiterleitung Ihres gesamten nicht zugeordneten Traffics auf eine kalte, sich noch aufwärmende IP würde Ihrer Zustellbarkeit schaden.

Eine IP meldet einen von vier Status:

Status	Bedeutung
`warming`	Die IP ist neu und wärmt sich auf. Sie übernimmt einen wachsenden Anteil Ihres Traffics; der Rest fließt über den Shared Pool.
`active`	Warmup abgeschlossen. Die IP verarbeitet volles Volumen.
`suspended`	Die IP ist vorübergehend gesperrt.
`pending_cancellation`	Sie haben die IP gekündigt. Sie sendet weiter bis zum Ende des bereits bezahlten Abrechnungszeitraums, zählt aber nicht mehr, wenn die Standard-Pool-Regeln den Pool auswerten.

IP-Pools

Pools trennen Sendeströme: Ein typisches Setup ist ein Pool für transaktionale E-Mails und ein weiterer für Marketing, damit die Reputation einer Kampagne niemals Ihre Passwort-Zurücksetzungen berührt. Pools können kostenlos erstellt werden, bis zum email_ip_pools_max-Kontingent Ihres Plans.

Codebeispiel

bird email ip-pools create Transactional

Codebeispiel

{
  "created_at": "2026-07-23T14:48:28Z",
  "id": "ipp_01ky7q6288fqnsghxyem91ryjv",
  "ips": [],
  "is_default": false,
  "name": "Transactional",
  "organization_id": "org_01ky7m21hjffg9pxj5xz6nx6ew",
  "protected": false,
  "updated_at": "2026-07-23T14:48:28Z"
}

Pools werden immer als Nicht-Standard und leer erstellt. Sie füllen sie, indem Sie direkt hinein kaufen (--ip-pool-id beim Kauf) oder vorhandene IPs verschieben. Das Auslesen eines Pools gibt seine enthaltenen IPs vollständig zurück:

Codebeispiel

bird email ip-pools get ipp_1btmn1nnkd8y6a4jckbkvvt9eh

Codebeispiel

{
  "created_at": "2026-06-29T13:56:39Z",
  "id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
  "ips": [
    {
      "address": "198.51.100.21",
      "created_at": "2026-06-29T13:56:39Z",
      "hostname": "mta1.send.goldcrest.dev",
      "id": "dip_5g8r8h31kr8cz8zp1p4s837r4m",
      "ip_pool_id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
      "organization_id": "org_01ky7m235keybaf72b0fdgfwj4",
      "purchased_at": "2026-06-29T13:56:39Z",
      "status": "active",
      "updated_at": "2026-07-23T13:56:39Z",
      "warmup_completed_at": "2026-07-15T13:56:39Z",
      "warmup_progress": 100,
      "warmup_started_at": "2026-06-29T13:56:39Z"
    }
  ],
  "is_default": false,
  "name": "Goldcrest Pool",
  "organization_id": "org_01ky7m235keybaf72b0fdgfwj4",
  "protected": false,
  "updated_at": "2026-07-23T13:56:39Z"
}

Pools gehören zur Organisation. Das hostname jeder IP wird beim Provisionieren automatisch zugewiesen; behandeln Sie es als Information, nicht als etwas, das Sie konfigurieren.

Der Bestand der Organisation enthält den Shared Bird.com Pool, markiert mit protected: true. Er hat eine Pool-ID, und der reservierte Alias ipp_shared verweist auf diesen Pool. Bird verwaltet ihn: Er kann nicht umbenannt oder gelöscht werden, er kann keine dedizierten IPs enthalten, und er wird nicht auf Ihr Pool-Kontingent angerechnet. Ein Workspace mit zugewiesenen Pools sieht ihn, wenn diesem Workspace der Shared Pool zugewiesen ist. Für den Alias benötigen Sie dieselbe Berechtigung wie für seine ID.

Wenn Workspace-Zuweisungen verfügbar sind, gibt das Dashboard neu erstellte Pools für den aktuellen Workspace frei. Erstellen Sie dort beim ersten Kauf einer dedizierten IP zunächst den Pool, bevor Sie die Zahlung bestätigen. Käufe über die API oder CLI ohne Pool-ID erstellen einen Organisationspool, der noch einem Workspace zugewiesen werden muss.

Wenn Workspace-Zuweisungen verfügbar sind, weisen Sie einen Pool zu, ohne den Standard des Workspace zu ändern:

Codebeispiel

bird email ip-pools workspaces assign ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --is-default=false

Bei einem Workspace ohne Zuweisungen bleibt damit auch der Versand über den Shared Pool erhalten, weil der Shared Pool als sein Standard zugewiesen wird. Wenn Sie --is-default weglassen oder auf true setzen, wird stattdessen der erste zugewiesene Pool zum Standard, und der Versand ist auf die zugewiesenen Pools beschränkt. Ein dedizierter Pool im Warmup braucht zusätzlich den Shared Pool als Zuweisung, weil der Überlauf während des Warmups geteilte IPs nutzt. Workspaces ohne Pool-Zuweisungen verwenden den Shared Pool.

Bevor Sie eine Zuweisung entfernen, ersetzen Sie jede Standardauswahl und jede gespeicherte Verwendung in Domain-Standardeinstellungen, Postfächern, SMTP-Einstellungen sowie in entworfenen, geplanten oder nicht abgeschlossenen Broadcasts. Der Verlauf abgeschlossener Broadcasts behält seine ursprüngliche Pool-Zuordnung und verhindert das Entfernen nicht.

Codebeispiel

bird email ip-pools workspaces remove ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --yes

Eine IP zwischen Pools verschieben

Eine dedizierte IP befindet sich immer in genau einem Pool, ohne nicht zugewiesenen Zustand. Das Verschieben ist eine einzelne Zuweisung:

Codebeispiel

bird email dedicated-ips assign dip_5g8r8h31kr8cz8zp1p4s837r4m --ip-pool-id ipp_01ky7q6288fqnsghxyem91ryjv

Der Shared Pool ist kein gültiges Ziel: Dedizierte IPs befinden sich nur in Ihren eigenen Pools.

Einen Pool löschen

Nur leere Pools können gelöscht werden. Das Löschen eines Pools, der noch IPs enthält, wird mit einem 409 abgelehnt; verschieben oder kündigen Sie zuerst seine IPs. Ersetzen Sie vor dem Löschen seine Standardauswahlen und entfernen Sie seine Workspace-Zuweisungen und gespeicherten Verwendungen.

Codebeispiel

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

Der Standard-Pool

Wenn weder ein Versand noch seine Absenderdomain einen Pool auswählt, verwenden wir Ihren Standard-Pool. Bei Organisationen, die Pools pro Workspace verwalten, ist dies der Standard des Workspace. Die folgenden Regeln gelten für diesen Standard:

Genau ein Pool ist immer der Standard. Der Shared Pool ist der anfängliche Standard, sodass dies ab dem ersten Tag gilt.
Der Standard wird verschoben, nie gelöscht. Ändern Sie ihn, indem Sie einen anderen Pool zum Standard machen. Das schaltet den bisherigen Standard im selben Moment ab, sodass es zu jedem Zeitpunkt genau einen Standard gibt. Das Abschalten von is_default beim aktuellen Standard wird mit einem 422 abgelehnt; um zum Shared Routing zurückzukehren, machen Sie stattdessen den Shared Pool zum Standard:

Codebeispiel

bird email ip-pools update ipp_shared --is-default

Wenn Ihre Organisation Pools pro Workspace verwaltet, wählen Sie stattdessen den Standard des Workspace:

Codebeispiel

bird email ip-pools workspaces assign ipp_shared ws_01krdgeqcxet5s7t44vh8rt9mg --is-default

Verwenden Sie Workspace-Zuweisungen, wenn die Operation update --is-default auf Organisationsebene IPPoolOrganizationDefaultRetired zurückgibt. Während der Umstellung können Änderungen an Zuweisungen vorübergehend nicht verfügbar sein. Wenn Sie den Standard eines Workspace ändern, bleiben die Standards anderer Workspaces unverändert.

Ein dedizierter Pool braucht mindestens eine IP, die nicht ausläuft, um Standard werden zu können. Eine warming-IP zählt; eine IP im Status pending_cancellation nicht. Ihr Standard kann nie ausschließlich durch IPs gestützt werden, die auslaufen. Der Shared Pool ist davon ausgenommen und ist immer ein gültiger Standard.
Die letzte verbleibende IP kann den Standard-Pool nicht verlassen. Solange ein Pool die Standard-Bezeichnung trägt, kann seine letzte IP weder gekündigt noch verschoben werden; wechseln Sie zuerst den Standard und leeren Sie dann den Pool.

Diese Prüfungen schützen geplante Änderungen. Wenn ein dedizierter Pool seine sendenden IPs oder die nötigen Berechtigungen verliert, schlagen Sendungen über diesen Pool fehl, bis Sie ihn wiederherstellen oder einen anderen zulässigen Standard wählen.

Pool beim Versand auswählen

Das Routing ist der Teil dieser Funktion, der in der öffentlichen API verfügbar ist. Wählen Sie einen Pool pro Nachricht mit dem optionalen Feld ip_pool_id bei POST /v1/email/messages:

await bird.email.send({
  from: "noreply@yourdomain.com",
  to: ["delivered@messagebird.dev"],
  subject: "Your receipt",
  html: "<p>Thanks for your order.</p>",
  ip_pool_id: "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
});

client.email.send(
    from_="noreply@yourdomain.com",
    to=["delivered@messagebird.dev"],
    subject="Your receipt",
    html="<p>Thanks for your order.</p>",
    ip_pool_id="ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
)

_, err := client.Email.Send(context.Background(), bird.EmailSendParams{
	From:     "noreply@yourdomain.com",
	To:       []string{"delivered@messagebird.dev"},
	Subject:  "Your receipt",
	HTML:     "<p>Thanks for your order.</p>",
	IpPoolId: "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
})

$bird->email->send(
    from: 'noreply@yourdomain.com',
    to: ['delivered@messagebird.dev'],
    subject: 'Your receipt',
    html: '<p>Thanks for your order.</p>',
    ipPoolId: 'ipp_1btmn1nnkd8y6a4jckbkvvt9eh',
);

bird email send \
  --from noreply@yourdomain.com \
  --html '<p>Thanks for your order.</p>' \
  --ip-pool-id ipp_1btmn1nnkd8y6a4jckbkvvt9eh \
  --subject 'Your receipt' \
  --to delivered@messagebird.dev

curl -X POST https://us1.platform.bird.com/v1/email/messages \
  -H "Authorization: Bearer $BIRD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "noreply@yourdomain.com",
    "to": ["delivered@messagebird.dev"],
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "ip_pool_id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh"
  }'

Die Auflösung funktioniert so:

ip_pool_id weggelassen: Der Versand verwendet den Standard-Pool der Absenderdomain im aktuellen Workspace, sofern einer festgelegt ist. Andernfalls verwendet er Ihr Standard-Routing.
ip_pool_id: "ipp_shared": Der Versand verwendet den Shared Pool, wenn Ihr Workspace ihn nutzen darf. Damit wählen Sie geteilte Infrastruktur, auch wenn ein dedizierter Pool Ihr Standard ist.
ip_pool_id auf eine Pool-ID gesetzt: Der Versand verwendet diesen Pool, wenn er für Ihren Workspace verfügbar ist.

Ein Wert, der unbekannt ist, für den Workspace nicht verfügbar ist oder einen Pool ohne verfügbare IPs benennt, wird mit einem 422 abgelehnt. Ein dedizierter Pool mit sich aufwärmenden IPs braucht außerdem die Berechtigung, den Shared Pool für den Warmup-Überlauf zu nutzen. Wenn Sie die Berechtigung für den Shared Pool entfernen, ist diese Warmup-Route nicht mehr verfügbar. Eine explizite Pool-Auswahl bleibt für angenommene Nachrichten erhalten und wird vor dem Senden erneut geprüft; wenn eine Berechtigung später entfernt wird, kann das die Zustellung stoppen. Bird ersetzt eine nicht verfügbare explizite Auswahl nicht durch einen anderen Pool.

Eine dedizierte IP kündigen

Die Kündigung erfolgt in zwei Phasen. Das Kündigen plant die Entfernung, statt die IP sofort zu entfernen:

Codebeispiel

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

Die IP wechselt in den Status pending_cancellation und erhält einen cancels_at-Zeitstempel, das Ende des bereits bezahlten Abrechnungszeitraums. Bis cancels_at sendet sie weiter als Teil ihres Pools; danach deprovisionieren wir sie innerhalb einer Stunde. Das Kündigen einer bereits ausstehenden IP hat keine weitere Wirkung.

Planen Sie die eine unmittelbare Konsequenz ein: Eine pending_cancellation-IP zählt sofort nicht mehr für die Standard-Pool-Regeln. Und der Standard-Pool-Schutz gilt weiterhin: Die letzte IP im Standard-Pool kann nicht gekündigt werden; verschieben Sie den Standard (zum Shared Pool oder einem anderen Pool) zuerst.

Nächste Schritte

IP-Warmup: Wie neue dedizierte IPs auf volles Volumen hochfahren und wann Sie Ihren Standard umstellen
E-Mail senden: Die vollständige Sendeanfrage, einschließlich ip_pool_id
Zustellbarkeit · E-Mail: Das Reputationsmodell, in das sich dedizierte IPs einfügen
Eine dedizierte IP kaufen: Ein Video, das eine IP im Dashboard kauft und den Start des Warmups zeigt

Weiter mit der Dokumentation, Anleitungen und Beispielen zu diesem Thema.

Implementierungs-Briefing erhalten

Verwandte Ressourcen