IP dédiées et pools

• Les nouvelles IP passent par un préchauffage automatique avant de pouvoir gérer le volume complet ; le surplus est routé via le pool partagé en attendant.
• Les IP et les pools appartiennent à votre organisation.

Où les gérer

Acheter une IP dédiée

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

• Lors de votre premier achat, vous pouvez omettre --ip-pool-id : nous créons votre premier pool, nommé "Dedicated IPs", et provisionnons les IP dedans. Dès que votre organisation possède au moins un pool, le flag est obligatoire ; vous choisissez où chaque nouvelle IP atterrit.
• Chaque IP est facturée sous forme d'abonnement mensuel. Quand le solde de votre portefeuille ne couvre pas l'achat, la réponse indique requires_topup (rechargez pour continuer) ou pending_topup (un paiement par carte est en cours de règlement) ; les IP sont provisionnées automatiquement dès que les fonds arrivent.
• Les achats sont limités par le quota email_ip_dedicated_max de votre plan, et les pools par email_ip_pools_max.

Pools d'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"
}

Déplacer une IP entre pools

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

Supprimer un pool

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv

Le pool par défaut

• Exactement un pool est toujours le pool par défaut. Le pool partagé est le pool par défaut initial : c'est donc vrai dès le premier jour.
• Le pool par défaut est déplacé, jamais vidé. Changez-le en désignant un autre pool comme défaut. Cela désactive le précédent au même instant, de sorte qu'à chaque instant il y a exactement un pool par défaut. Désactiver is_default sur le pool par défaut actuel est rejeté avec une erreur 422 ; pour revenir au routage partagé, désignez plutôt le pool partagé comme défaut :

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

• Un pool dédié doit contenir au moins une IP qui n'est pas en cours de désactivation pour devenir le pool par défaut. Une IP warming compte ; une IP en pending_cancellation ne compte pas. Votre pool par défaut ne peut jamais reposer uniquement sur des IP en voie de suppression. Le pool partagé est exempté et constitue toujours un pool par défaut valide.
• La dernière IP restante ne peut pas quitter le pool par défaut. Tant qu'un pool porte la désignation par défaut, sa dernière IP ne peut être ni annulée ni déplacée ; changez d'abord le pool par défaut, puis videz le pool.

Sélectionner un pool au moment de l'envoi

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 omis : l'envoi utilise votre pool par défaut.
• ip_pool_id: "ipp_shared" : l'envoi passe par le pool partagé, quel que soit votre pool par défaut. Utile pour maintenir un flux à faible enjeu sur l'infrastructure partagée pendant qu'un pool dédié est votre pool par défaut.
• ip_pool_id défini sur l'un de vos identifiants de pool : l'envoi passe par ce pool.

Annuler une IP dédiée

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m

Étapes suivantes

• Préchauffage d'IP : comment les nouvelles IP dédiées montent en charge jusqu'au volume complet, et quand basculer votre pool par défaut
• Envoyer un e-mail : la requête d'envoi complète, y compris ip_pool_id
• Délivrabilité · Email : le modèle de réputation dans lequel s'inscrivent les IP dédiées
• Acheter une IP dédiée : une vidéo qui en achète une dans le tableau de bord et montre le début du préchauffage