IPs dedicados e pools

• Novos IPs passam por um aquecimento automático antes de suportar volume total; o excedente é roteado pelo pool compartilhado nesse meio-tempo.
• IPs e pools pertencem à sua organização.

Onde você os gerencia

Comprar um IP dedicado

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

• Na sua primeira compra você pode omitir --ip-pool-id: nós criamos seu primeiro pool, chamado "Dedicated IPs", e provisionamos os IPs nele. Quando sua organização já tem pelo menos um pool, o campo é obrigatório; você escolhe onde cada novo IP é alocado.
• Cada IP é cobrado como assinatura mensal. Quando o saldo da sua carteira não cobre a compra, a resposta reporta requires_topup (adicione saldo para prosseguir) ou pending_topup (uma cobrança no cartão está sendo processada); os IPs são provisionados automaticamente assim que os fundos chegam.
• Compras são limitadas pela cota de email_ip_dedicated_max do seu plano, e pools pela cota de 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 um IP entre pools

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

Excluir um pool

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

O pool padrão

• Exatamente um pool é sempre o padrão. O pool compartilhado é o padrão inicial, então isso é verdade desde o primeiro dia.
• O padrão é movido, nunca removido. Altere-o tornando outro pool o padrão. Isso desativa o padrão anterior no mesmo instante, então todo momento tem exatamente um padrão. Desativar is_default no padrão atual é rejeitado com um 422; para voltar ao roteamento compartilhado, torne o pool compartilhado o padrão:

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

• Um pool dedicado precisa de pelo menos um IP que não esteja em encerramento para se tornar o padrão. Um IP warming conta; um IP em pending_cancellation não conta. Seu padrão nunca pode ser sustentado exclusivamente por IPs a caminho da desativação. O pool compartilhado é isento e é sempre um padrão válido.
• O último IP restante não pode sair do pool padrão. Enquanto um pool detém a designação de padrão, seu último IP não pode ser cancelado nem movido; troque o padrão primeiro, depois esvazie o pool.

Selecionar um pool no momento do envio

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: o envio usa seu pool padrão.
• ip_pool_id: "ipp_shared": o envio é roteado pelo pool compartilhado independentemente do seu padrão. Útil para manter um fluxo de baixa prioridade na infraestrutura compartilhada enquanto um pool dedicado é seu padrão.
• ip_pool_id definido como um dos IDs dos seus pools: o envio passa por esse pool.

Cancelar um IP dedicado

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Próximos passos

• Aquecimento de IP: como novos IPs dedicados aumentam até o volume total e quando trocar seu padrão
• Envio de e-mail: a solicitação completa de envio, incluindo ip_pool_id
• Entregabilidade · Email: o modelo de reputação no qual os IPs dedicados se encaixam
• Comprar um IP dedicado: um vídeo que compra um no dashboard e mostra o início do aquecimento