Dedicated IP's en pools

Op gedeelde infrastructuur vertrekt je e-mail vanaf IP-adressen die je deelt met andere klanten. We houden die IP's gezond, maar je reputatie is nog steeds gebundeld met die van alle anderen. Een dedicated IP is een adres waar alleen jouw organisatie vanaf verstuurt, zodat mailboxproviders je verkeer uitsluitend op jouw eigen trackrecord beoordelen. IP-pools groeperen dedicated IP's in routeerbare eenheden, en het ip_pool_id-veld op een verzending kiest de pool voor dat bericht.

Je hebt nooit dedicated IP's nodig om te versturen. Elke organisatie begint met de Shared Bird.com Pool als standaard, dus e-mail stroomt vanaf dag één zonder iets te configureren. Dedicated IP's zijn een betaalde uitbreiding die alleen rendeert bij consistent volume. Een weinig gebruikte dedicated IP bouwt langzamer reputatie op dan de gedeelde pool al heeft, dus verzenders met weinig volume zijn meestal beter af met de gedeelde pool. Verbetert een dedicated IP de e-mailaflevering? legt uit hoe verzendvolume en reputatie die keuze beïnvloeden.

Twee dingen om te weten voordat je koopt:

• Nieuwe IP's doorlopen een automatische opwarming voordat ze volledig volume aankunnen; overflow gaat in de tussentijd via de gedeelde pool.
• IP's en pools behoren tot je organisatie.

Waar je ze beheert

Beheer pools en IP's in Email > IP pools in het dashboard, of met de bird email ip-pools- en bird email dedicated-ips-CLI-commando's. Voor deze bewerkingen heb je machtigingen op organisatieniveau nodig. De SDK's bevatten geen getypte beheermethoden. Om een bericht via een pool te routeren, stel je ip_pool_id in zoals beschreven in Een pool selecteren bij verzending.

Als je organisatie de toegang tot pools per werkruimte beheert, toont de pagina Email > IP pools van de organisatie de inventaris van de organisatie en de toewijzingen aan werkruimtes. Een werkruimtepagina toont de pools die die werkruimte mag gebruiken. Om die toewijzingen te wijzigen heb je machtigingen op organisatieniveau nodig. Toegang tot een werkruimte geeft geen toegang tot de pools van andere werkruimtes.

Een dedicated IP kopen

Koop een IP via het tabblad Dedicated IPs of met de CLI:

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

• Bij je eerste aankoop kun je --ip-pool-id weglaten: we maken je eerste pool aan met de naam "Dedicated IPs" en plaatsen de IP's erin. Zodra je organisatie minstens één pool heeft, is de vlag verplicht; je kiest waar elk nieuw IP terechtkomt.
• Elk IP wordt gefactureerd als maandelijks abonnement. Wanneer je walletsaldo de aankoop niet dekt, meldt het antwoord requires_topup (vul aan om door te gaan) of pending_topup (een kaartbetaling wordt verwerkt); de IP's worden automatisch ingericht zodra het saldo beschikbaar is.
• Aankopen zijn begrensd door het email_ip_dedicated_max-quotum van je abonnement, en pools door email_ip_pools_max.

Elk ingerichte IP begint met de status warming en schaalt automatisch op; IP-opwarming behandelt het schema en hoe je het kunt monitoren. De hostname van het IP is de reverse-DNS-naam (PTR), de naam waarmee het zich voorstelt aan ontvangende mailservers; voeg deze toe aan elke allowlist die filtert op verzendhostnaam.

Een IP kopen verandert niet je standaardpool. De gedeelde pool blijft de standaard totdat je expliciet wisselt, omdat het routeren van al je niet-gespecificeerde verkeer naar een koud, nog opwarmend IP je aflevering zou schaden.

Een IP rapporteert een van vier statussen:

IP-pools

Pools scheiden verzendstromen: een veelgebruikte opzet is één pool voor transactionele mail en een andere voor marketing, zodat de reputatie van een campagne nooit je wachtwoordresets raakt. Pools zijn gratis aan te maken, tot aan het email_ip_pools_max-quotum van je abonnement.

bird email ip-pools create Transactional

{
  "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 worden altijd als niet-standaard en leeg aangemaakt. Je vult ze door er rechtstreeks in te kopen (--ip-pool-id bij de aankoop) of door bestaande IP's erin te verplaatsen. Het uitlezen van een pool geeft de bijbehorende IP's volledig terug:

bird email ip-pools get ipp_1btmn1nnkd8y6a4jckbkvvt9eh

{
  "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 zijn eigendom van de organisatie. De hostname van elk IP wordt automatisch toegewezen wanneer het IP wordt ingericht; beschouw het als informatief, niet als iets dat je configureert.

De inventaris van de organisatie bevat de Shared Bird.com Pool, gemarkeerd als protected: true. Deze heeft een pool-ID, en de gereserveerde alias ipp_shared verwijst naar die pool. Bird beheert hem: hij kan niet hernoemd of verwijderd worden, kan geen dedicated IP's bevatten en telt niet mee voor je poolquotum. Een werkruimte met toegewezen pools ziet hem wanneer de gedeelde pool aan die werkruimte is toegewezen. Voor het gebruik van de alias heb je dezelfde machtiging nodig als voor het gebruik van de ID.

Wanneer werkruimtetoewijzingen beschikbaar zijn, geeft het dashboard de huidige werkruimte toegang tot nieuw aangemaakte pools. Maak bij je eerste aankoop van een dedicated IP via het dashboard eerst de pool aan voordat je de betaling bevestigt. Aankopen via de API of CLI zonder pool-ID maken een organisatiepool aan die nog aan een werkruimte moet worden toegewezen.

Wanneer toewijzingen aan werkruimtes beschikbaar zijn, wijs je een pool toe zonder de standaard van de werkruimte te wijzigen:

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

Bij een werkruimte zonder toewijzingen blijft verzenden via de gedeelde pool zo ook mogelijk, omdat de gedeelde pool als standaard wordt toegewezen. Als je --is-default weglaat of op true zet, wordt in plaats daarvan de eerste toegewezen pool de standaard en is verzenden beperkt tot de toegewezen pools. Een opwarmende dedicated pool heeft ook de gedeelde pool als toewijzing nodig, omdat overflow tijdens de opwarming gedeelde IP's gebruikt. Werkruimtes zonder pooltoewijzingen gebruiken de gedeelde pool.

Om een toewijzing te verwijderen, vervang je eerst elke standaardselectie en elk opgeslagen gebruik in domeinstandaarden, mailboxen, SMTP-instellingen of concept-, geplande of onvoltooide broadcasts. De geschiedenis van voltooide broadcasts behoudt de oorspronkelijke pool en blokkeert het verwijderen niet.

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

Een IP verplaatsen tussen pools

Een dedicated IP zit altijd in precies één pool, zonder niet-toegewezen status. Verplaatsen is een enkele toewijzing:

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

De gedeelde pool is geen geldige bestemming: dedicated IP's bestaan alleen in je eigen pools.

Een pool verwijderen

Alleen lege pools kunnen worden verwijderd. Het verwijderen van een pool die nog IP's bevat, wordt geweigerd met een 409; verplaats of annuleer eerst de IP's. Vervang de standaardselecties van de pool en verwijder de toewijzingen aan werkruimtes en opgeslagen gebruik voordat je hem verwijdert.

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

De standaardpool

Wanneer noch een verzending noch het verzenddomein een pool selecteert, gebruiken we je standaardpool. Voor organisaties die pools per werkruimte beheren, is dit de standaard van de werkruimte. De onderstaande regels gelden voor die standaard:

• Er is altijd precies één pool de standaard. De gedeelde pool is de initiële standaard, dus dat geldt vanaf dag één.
• De standaard wordt verplaatst, nooit gewist. Wijzig hem door een andere pool de standaard te maken. Dat schakelt de vorige standaard op hetzelfde moment uit, zodat er elk moment precies één standaard is. Het uitzetten van is_default op de huidige standaard wordt geweigerd met een 422; om terug te gaan naar gedeelde routering maak je de gedeelde pool weer de standaard:

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

Als je organisatie pools per werkruimte beheert, selecteer je in plaats daarvan de standaard van de werkruimte:

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

Gebruik toewijzingen aan werkruimtes wanneer de update --is-default-bewerking op organisatieniveau IPPoolOrganizationDefaultRetired teruggeeft. Tijdens de overgang kunnen wijzigingen in toewijzingen tijdelijk niet beschikbaar zijn. Als je de standaard van één werkruimte wijzigt, blijven de standaarden van andere werkruimtes ongewijzigd.

• Een dedicated pool heeft minstens één IP nodig dat niet wordt afgebouwd om de standaard te worden. Een warming-IP telt mee; een IP in pending_cancellation niet. Je standaard kan nooit uitsluitend worden gedragen door IP's die op weg naar buiten zijn. De gedeelde pool is uitgezonderd en is altijd een geldige standaard.
• Het laatst overgebleven IP kan de standaardpool niet verlaten. Zolang een pool de standaardaanduiding draagt, kan het laatste IP niet worden geannuleerd of wegverplaatst; wissel eerst de standaard, en leeg dan de pool.

Deze controles beschermen geplande wijzigingen. Als een dedicated pool zijn verzendende IP's of de benodigde machtigingen verliest, mislukken verzendingen via die pool totdat je hem herstelt of een andere toegestane standaard kiest.

Een pool selecteren bij verzending

Routering is het deel van deze functie dat in de publieke API leeft. Kies een pool per bericht met het optionele ip_pool_id-veld op 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"
  }'

De afhandeling werkt als volgt:

• ip_pool_id weggelaten: de verzending gebruikt de standaardpool van het verzenddomein in de huidige werkruimte, als die is ingesteld; anders gebruikt de verzending je standaardroutering.
• ip_pool_id: "ipp_shared": de verzending gebruikt de gedeelde pool wanneer je werkruimte die mag gebruiken. Zo kies je gedeelde infrastructuur, ook als een dedicated pool je standaard is.
• ip_pool_id ingesteld op een pool-ID: de verzending gebruikt die pool wanneer die beschikbaar is voor je werkruimte.

Een waarde die onbekend is, niet beschikbaar is voor de werkruimte of een pool aanduidt zonder beschikbare IP's, wordt geweigerd met een 422. Een dedicated pool met opwarmende IP's heeft ook toestemming nodig om de gedeelde pool te gebruiken voor overflow tijdens de opwarming. Als je die toestemming voor de gedeelde pool intrekt, is die opwarmroute niet meer beschikbaar. Een expliciete poolkeuze blijft bewaard voor geaccepteerde berichten en wordt vóór verzending opnieuw gecontroleerd; als je later een toestemming intrekt, kan dat de aflevering stoppen. Bird vervangt een niet-beschikbare expliciete keuze niet door een andere pool.

Een dedicated IP annuleren

Annulering verloopt in twee fasen. Annuleren plant de verwijdering in plaats van het IP onmiddellijk te verwijderen:

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

Het IP gaat over naar pending_cancellation en krijgt een cancels_at-tijdstempel, het einde van de factureringsperiode die je al hebt betaald. Tot cancels_at blijft het versturen als onderdeel van zijn pool; daarna deprovisioneren we het binnen het uur. Het annuleren van een IP dat al in afwachting is, heeft geen verder effect.

Houd rekening met het ene directe gevolg: een pending_cancellation-IP telt direct niet meer mee voor de standaardpoolregels. En de standaardpoolbeveiliging blijft gelden: het laatste IP in de standaardpool kan niet worden geannuleerd; verplaats de standaard (naar de gedeelde pool of een andere pool) eerst.

Volgende stappen

• IP-opwarming: hoe nieuwe dedicated IP's opschalen naar volledig volume, en wanneer je je standaard wisselt
• E-mail versturen: het volledige verzendverzoek, inclusief ip_pool_id
• Aflevering · Email: het reputatiemodel waar dedicated IP's in passen
• Een dedicated IP kopen: een video waarin er een wordt gekocht in het dashboard en de opwarming begint