IP dedikasi dan pool

• IP baru melewati proses warmup otomatis sebelum dapat menangani volume penuh; kelebihan lalu lintas dialihkan melalui shared pool sementara waktu.
• IP dan pool dimiliki oleh organisasi Anda.

Tempat mengelolanya

Membeli IP dedikasi

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

• Pada pembelian pertama Anda dapat menghilangkan --ip-pool-id: kami membuat pool pertama Anda, bernama "Dedicated IPs", dan menyediakan IP ke dalamnya. Setelah organisasi Anda memiliki setidaknya satu pool, flag tersebut wajib; Anda memilih di mana setiap IP baru ditempatkan.
• Setiap IP ditagih sebagai langganan bulanan. Ketika saldo wallet Anda tidak mencukupi pembelian, respons melaporkan requires_topup (isi ulang untuk melanjutkan) atau pending_topup (pembayaran kartu sedang diproses); IP disediakan secara otomatis begitu dana masuk.
• Pembelian dibatasi oleh kuota email_ip_dedicated_max paket Anda, dan pool oleh email_ip_pools_max.

IP pool

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

Memindahkan IP antar pool

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

Menghapus pool

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

Default pool

• Tepat satu pool selalu menjadi default. Shared pool adalah default awal, sehingga hal ini berlaku sejak hari pertama.
• Default dipindahkan, tidak pernah dikosongkan. Ubah default dengan menjadikan pool lain sebagai default. Ini menonaktifkan default sebelumnya pada saat yang sama, sehingga setiap saat selalu ada tepat satu default. Menonaktifkan is_default pada default saat ini ditolak dengan 422; untuk kembali ke routing bersama, jadikan shared pool sebagai default:

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

• Pool dedikasi memerlukan setidaknya satu IP yang tidak sedang dihentikan untuk menjadi default. IP warming dihitung; IP dalam pending_cancellation tidak. Default Anda tidak boleh hanya didukung oleh IP yang akan dihentikan. Shared pool dikecualikan dan selalu menjadi default yang valid.
• IP terakhir tidak dapat meninggalkan default pool. Selama pool memegang penetapan default, IP terakhirnya tidak dapat dibatalkan maupun dipindahkan; pindahkan default terlebih dahulu, lalu kosongkan pool.

Memilih pool saat mengirim

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 dihilangkan: pengiriman menggunakan default pool Anda.
• ip_pool_id: "ipp_shared": pengiriman dialihkan melalui shared pool terlepas dari default Anda. Berguna untuk menjaga aliran berisiko rendah pada infrastruktur bersama sementara pool dedikasi menjadi default Anda.
• ip_pool_id diatur ke salah satu pool ID Anda: pengiriman melewati pool tersebut.

Membatalkan IP dedikasi

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Langkah selanjutnya

• IP warmup: cara IP dedikasi baru meningkat ke volume penuh, dan kapan mengalihkan default Anda
• Mengirim email: permintaan kirim lengkap, termasuk ip_pool_id
• Deliverability · Email: model reputasi tempat IP dedikasi terhubung
• Membeli IP dedicated: video yang membeli IP di dashboard dan menunjukkan warm-up dimulai