IP dedicati e pool

• I nuovi IP passano attraverso un warmup automatico prima di poter gestire il volume pieno; nel frattempo il traffico in eccesso transita dal pool condiviso.
• IP e pool appartengono alla tua organizzazione.

Dove gestirli

Acquistare un IP dedicato

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

• Al primo acquisto puoi omettere --ip-pool-id: creiamo il tuo primo pool, denominato "Dedicated IPs", e vi assegniamo gli IP. Una volta che la tua organizzazione ha almeno un pool, il flag è obbligatorio; scegli tu dove collocare ogni nuovo IP.
• Ogni IP è fatturato come abbonamento mensile. Quando il saldo del tuo wallet non copre l'acquisto, la risposta riporta requires_topup (ricarica per procedere) o pending_topup (un addebito su carta è in fase di regolamento); gli IP vengono assegnati automaticamente non appena i fondi arrivano.
• Gli acquisti sono limitati dalla quota email_ip_dedicated_max del tuo piano, e i pool dalla quota 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"
}

Spostare un IP tra pool

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

Eliminare un pool

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

Il pool predefinito

• Esattamente un pool è sempre il predefinito. Il pool condiviso è il predefinito iniziale, quindi questo è vero dal primo giorno.
• Il predefinito viene spostato, mai rimosso. Cambialo rendendo un altro pool il predefinito. Questo disattiva il predefinito precedente nello stesso istante, così in ogni momento ce n'è esattamente uno. Disattivare is_default sul predefinito corrente viene rifiutato con un errore 422; per tornare all'instradamento condiviso, rendi invece il pool condiviso il predefinito:

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

• Un pool dedicato ha bisogno di almeno un IP che non sia in fase di dismissione per diventare il predefinito. Un IP warming conta; un IP in pending_cancellation no. Il tuo predefinito non può mai essere supportato esclusivamente da IP in via di dismissione. Il pool condiviso è esente ed è sempre un predefinito valido.
• L'ultimo IP rimasto non può lasciare il pool predefinito. Finché un pool detiene la designazione di predefinito, il suo ultimo IP non può essere né cancellato né spostato; cambia prima il predefinito, poi svuota il pool.

Selezionare un pool al momento dell'invio

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 omesso: l'invio utilizza il tuo pool predefinito.
• ip_pool_id: "ipp_shared": l'invio transita dal pool condiviso indipendentemente dal tuo predefinito. Utile per mantenere un flusso a bassa priorità sull'infrastruttura condivisa mentre un pool dedicato è il tuo predefinito.
• ip_pool_id impostato su uno dei tuoi pool ID: l'invio passa attraverso quel pool.

Cancellare un IP dedicato

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Passi successivi

• IP warmup: come i nuovi IP dedicati scalano fino al volume pieno e quando cambiare il predefinito
• Invio di email: la richiesta di invio completa, incluso ip_pool_id
• Deliverability · Email: il modello di reputazione in cui si inseriscono gli IP dedicati
• Acquistare un IP dedicato: un video che ne acquista uno nella dashboard e mostra l'inizio del warmup