Dedicated IP's en pools

• 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

Een dedicated IP kopen

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.

IP-pools

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"
}

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"
}

Een IP verplaatsen tussen pools

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

Een pool verwijderen

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

De standaardpool

• 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

• 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.

Een pool selecteren bij verzending

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

{
  "name": "email_send",
  "arguments": {
    "from": {
      "email": "noreply@yourdomain.com"
    },
    "html": "<p>Thanks for your order.</p>",
    "ip_pool_id": "ipp_1btmn1nnkd8y6a4jckbkvvt9eh",
    "subject": "Your receipt",
    "to": [
      {
        "email": "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"
  }'

• ip_pool_id weggelaten: de verzending gebruikt je standaardpool.
• ip_pool_id: "ipp_shared": de verzending gaat via de gedeelde pool, ongeacht je standaard. Handig om een stroom met weinig impact op gedeelde infrastructuur te houden terwijl een dedicated pool je standaard is.
• ip_pool_id ingesteld op een van je pool-ID's: de verzending gaat via die pool.

Een dedicated IP annuleren

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

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