IPs dedicadas y pools

• Las IPs nuevas pasan por un calentamiento automático antes de poder manejar el volumen completo; mientras tanto, el excedente se enruta por el pool compartido.
• Las IPs y los pools pertenecen a tu organización.

Dónde los gestionas

Comprar una IP dedicada

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

• En tu primera compra puedes omitir --ip-pool-id: creamos tu primer pool, llamado "Dedicated IPs", y aprovisionamos las IPs en él. Una vez que tu organización tiene al menos un pool, el flag es obligatorio; tú eliges dónde se ubica cada nueva IP.
• Cada IP se factura como suscripción mensual. Cuando el saldo de tu wallet no cubre la compra, la respuesta indica requires_topup (recarga para continuar) o pending_topup (se está procesando un cargo con tarjeta); las IPs se aprovisionan automáticamente cuando llegan los fondos.
• Las compras están limitadas por la cuota email_ip_dedicated_max de tu plan, y los pools por 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"
}

Mover una IP entre pools

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

Eliminar un pool

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

El pool predeterminado

• Exactamente un pool es siempre el predeterminado. El pool compartido es el predeterminado inicial, así que esto se cumple desde el primer día.
• El predeterminado se mueve, nunca se borra. Cámbialo convirtiendo otro pool en el predeterminado. Eso desactiva el predeterminado anterior en el mismo instante, de modo que en todo momento hay exactamente un predeterminado. Desactivar is_default en el predeterminado actual se rechaza con un 422; para volver al enrutamiento compartido, convierte el pool compartido en el predeterminado:

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

• Un pool dedicado necesita al menos una IP que no esté en proceso de baja para convertirse en el predeterminado. Una IP en warming cuenta; una IP en pending_cancellation no. Tu predeterminado nunca puede estar respaldado únicamente por IPs de salida. El pool compartido está exento y siempre es un predeterminado válido.
• La última IP no puede salir del pool predeterminado. Mientras un pool tiene la designación de predeterminado, su última IP no se puede cancelar ni mover; cambia el predeterminado primero y después vacía el pool.

Seleccionar un pool en el momento del envío

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 omitido: el envío usa tu pool predeterminado.
• ip_pool_id: "ipp_shared": el envío se enruta por el pool compartido sin importar tu predeterminado. Útil para mantener un flujo de baja prioridad en infraestructura compartida mientras un pool dedicado es tu predeterminado.
• ip_pool_id configurado con uno de tus pool IDs: el envío pasa por ese pool.

Cancelar una IP dedicada

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Próximos pasos

• Calentamiento de IP: cómo las IPs dedicadas nuevas aumentan hasta el volumen completo y cuándo cambiar tu predeterminado
• Enviar correo: la solicitud de envío completa, incluido ip_pool_id
• Entregabilidad · Email: el modelo de reputación en el que se integran las IPs dedicadas
• Comprar una IP dedicada: un video que compra una en el dashboard y muestra el inicio del calentamiento