Dedykowane adresy IP i pule

• Nowe adresy IP przechodzą automatyczny warmup, zanim będą mogły obsłużyć pełny wolumen; nadmiar ruchu w tym czasie trafia przez pulę współdzieloną.
• Adresy IP i pule należą do Twojej organizacji.

Gdzie nimi zarządzasz

Kup dedykowany adres IP

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

• Przy pierwszym zakupie możesz pominąć --ip-pool-id: tworzymy Twoją pierwszą pulę o nazwie "Dedicated IPs" i przypisujemy do niej adresy IP. Gdy Twoja organizacja ma już co najmniej jedną pulę, flaga jest wymagana; sam wybierasz, gdzie trafia każdy nowy adres IP.
• Każdy adres IP jest rozliczany jako miesięczna subskrypcja. Gdy saldo portfela nie pokrywa zakupu, odpowiedź zwraca requires_topup (doładuj konto, aby kontynuować) lub pending_topup (trwa rozliczanie płatności kartą); adresy IP zostaną udostępnione automatycznie po zaksięgowaniu środków.
• Zakupy są ograniczone limitem email_ip_dedicated_max Twojego planu, a pule limitem email_ip_pools_max.

Pule IP

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

Przenieś adres IP między pulami

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

Usuń pulę

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

Domyślna pula

• Dokładnie jedna pula jest zawsze domyślna. Pula współdzielona jest początkową domyślną, więc ta zasada obowiązuje od pierwszego dnia.
• Domyślną pulę przenosi się, a nie usuwa. Zmień ją, wyznaczając inną pulę jako domyślną. Poprzednia domyślna traci status w tej samej chwili, więc w każdym momencie jest dokładnie jedna domyślna. Wyłączenie is_default na bieżącej domyślnej jest odrzucane z błędem 422; aby wrócić do routingu współdzielonego, ustaw pulę współdzieloną jako domyślną:

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

• Dedykowana pula potrzebuje co najmniej jednego adresu IP, który nie jest wygaszany, aby mogła zostać domyślną. Adres IP w statusie warming się liczy; adres IP w statusie pending_cancellation nie. Twoja domyślna pula nigdy nie może opierać się wyłącznie na adresach IP na drodze do wycofania. Pula współdzielona jest wyjątkiem i jest zawsze prawidłową domyślną.
• Ostatni pozostały adres IP nie może opuścić domyślnej puli. Dopóki pula ma status domyślnej, jej ostatniego adresu IP nie można ani anulować, ani przenieść; najpierw przełącz domyślną, potem opróżnij pulę.

Wybierz pulę w momencie wysyłki

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 pominięte: wysyłka korzysta z Twojej domyślnej puli.
• ip_pool_id: "ipp_shared": wysyłka trafia przez pulę współdzieloną niezależnie od Twojej domyślnej. Przydatne, gdy chcesz utrzymać mało istotny strumień na infrastrukturze współdzielonej, a Twoją domyślną jest pula dedykowana.
• ip_pool_id ustawione na jeden z identyfikatorów Twoich pul: wysyłka trafia przez tę pulę.

Anulowanie dedykowanego adresu IP

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Następne kroki

• IP warmup: jak nowe dedykowane adresy IP rozgrzewają się do pełnego wolumenu i kiedy przełączyć domyślną
• Wysyłanie e-maili: pełne żądanie wysyłki, w tym ip_pool_id
• Dostarczalność · Email: model reputacji, w który wpinają się dedykowane adresy IP
• Zakup dedykowanego IP: wideo pokazujące zakup w dashboardzie i początek rozgrzewania