IP dédiées et pools

Sur une infrastructure partagée, vos e-mails partent d'adresses IP que vous partagez avec d'autres clients. Nous maintenons ces IP en bonne santé, mais votre réputation reste mutualisée avec celle de tout le monde. Une IP dédiée est une adresse depuis laquelle seule votre organisation envoie : les fournisseurs de messagerie jugent donc votre trafic uniquement sur votre propre historique. Les pools d'IP regroupent les IP dédiées en unités routables, et le champ ip_pool_id d'un envoi sélectionne le pool pour ce message.

Vous n'avez jamais besoin d'IP dédiées pour envoyer. Chaque organisation démarre avec le Shared Bird.com Pool comme pool par défaut : les e-mails partent dès le premier jour sans rien à configurer. Les IP dédiées sont un module payant qui ne se rentabilise qu'avec un volume régulier. Une IP dédiée peu utilisée construit sa réputation plus lentement que le pool partagé ne l'a déjà fait : les expéditeurs à faible volume ont donc généralement intérêt à rester sur le pool partagé. Une IP dédiée améliore-t-elle la délivrabilité des e-mails ? explique comment le volume d'envoi et la réputation influencent ce choix.

Deux points à connaître avant d'acheter :

• 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

Gérez les pools et les IP dans Email > IP pools dans le tableau de bord, ou avec les commandes CLI bird email ip-pools et bird email dedicated-ips. Ces opérations requièrent des permissions au niveau de l'organisation. Les SDK n'incluent pas de méthodes de gestion typées. Pour router un message via un pool, définissez ip_pool_id comme décrit dans Sélectionner un pool au moment de l'envoi.

Si votre organisation gère l'accès aux pools par espace de travail, sa page Email > IP pools affiche l'inventaire de l'organisation et les affectations des espaces de travail. La page d'un espace de travail affiche les pools que cet espace de travail peut utiliser. Des permissions d'organisation sont nécessaires pour modifier ces affectations ; l'accès à un espace de travail ne donne pas accès aux pools des autres espaces de travail.

Acheter une IP dédiée

Achetez une IP depuis l'onglet Dedicated IPs ou avec la commande CLI :

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.

Chaque IP provisionnée démarre avec le statut warming et monte en charge automatiquement ; Préchauffage d'IP couvre le calendrier et la façon de le suivre. Le champ hostname de l'IP est son nom reverse-DNS (PTR), le nom avec lequel elle se présente aux serveurs de messagerie destinataires ; ajoutez-le à toute liste d'autorisation qui filtre sur le nom d'hôte expéditeur.

Acheter une IP ne change pas votre pool par défaut. Le pool partagé reste le pool par défaut tant que vous ne le changez pas explicitement, car router tout votre trafic non spécifié vers une IP froide encore en préchauffage nuirait à votre délivrabilité.

Une IP indique l'un des quatre statuts suivants :

Pools d'IP

Les pools séparent les flux d'envoi : une configuration courante consiste à avoir un pool pour le courrier transactionnel et un autre pour le marketing, afin que la réputation d'une campagne n'affecte jamais vos réinitialisations de mot de passe. Les pools sont gratuits à créer, dans la limite du quota email_ip_pools_max de votre plan.

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

Les pools sont toujours créés vides et non définis par défaut. Vous les remplissez en achetant directement dedans (--ip-pool-id lors de l'achat) ou en y déplaçant des IP existantes. La lecture d'un pool renvoie l'intégralité de ses IP membres :

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

Les pools appartiennent à l'organisation. Le champ hostname de chaque IP est attribué automatiquement lors du provisionnement ; considérez-le comme informatif plutôt que comme un élément à configurer.

L'inventaire de l'organisation inclut le Shared Bird.com Pool, marqué protected: true. Il possède un identifiant de pool, et l'alias réservé ipp_shared pointe vers ce pool. Bird le gère : il ne peut être ni renommé ni supprimé, il ne peut pas contenir d'IP dédiées, et il ne compte pas dans votre quota de pools. Un espace de travail doté de pools affectés le voit lorsque le pool partagé est affecté à cet espace de travail. L'utilisation de l'alias requiert la même permission que l'utilisation de son identifiant.

Lorsque les attributions aux espaces de travail sont disponibles, le tableau de bord donne à l’espace de travail actuel accès aux pools nouvellement créés. Pour votre premier achat d’une IP dédiée depuis le tableau de bord, créez son pool avant de confirmer le paiement. Les achats via l’API ou la CLI sans ID de pool créent un pool de l’organisation qui doit encore être attribué à un espace de travail.

Lorsque les affectations d'espaces de travail sont disponibles, accordez un pool sans modifier le pool par défaut de l'espace de travail :

bird email ip-pools workspaces assign ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --is-default=false

Pour un espace de travail sans affectation, cette opération préserve aussi l'envoi partagé en affectant le pool partagé comme pool par défaut. Si vous omettez --is-default ou le définissez sur true, le premier pool affecté devient le pool par défaut et l'envoi est limité aux pools affectés. Un pool dédié en préchauffage nécessite aussi l'affectation du pool partagé, car le surplus du préchauffage utilise des IP partagées. Les espaces de travail sans affectation de pool utilisent le pool partagé.

Pour retirer une affectation, remplacez d'abord toute sélection par défaut et toute utilisation enregistrée dans les valeurs par défaut des domaines, les boîtes aux lettres, les paramètres SMTP, ou les diffusions en brouillon, planifiées ou inachevées. L'historique des diffusions terminées conserve l'identité de son pool d'origine et ne bloque pas le retrait.

bird email ip-pools workspaces remove ipp_1btmn1nnkd8y6a4jckbkvvt9eh ws_01krdgeqcxet5s7t44vh8rt9mg --yes

Déplacer une IP entre pools

Une IP dédiée se trouve toujours dans exactement un pool, sans état non assigné. Le déplacement est une simple affectation :

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

Le pool partagé n'est pas une destination valide : les IP dédiées ne résident que dans vos propres pools.

Supprimer un pool

Seuls les pools vides peuvent être supprimés. La suppression d'un pool contenant encore des IP est rejetée avec une erreur 409 ; déplacez ou annulez d'abord ses IP. Avant de supprimer le pool, remplacez ses sélections par défaut et retirez ses affectations d'espaces de travail et ses utilisations enregistrées.

bird email ip-pools delete ipp_01ky7q6288fqnsghxyem91ryjv --yes

Le pool par défaut

Quand ni un envoi ni son domaine d'envoi ne sélectionne de pool, nous utilisons votre pool par défaut. Pour les organisations qui gèrent les pools par espace de travail, il s'agit du pool par défaut de l'espace de travail. Les règles ci-dessous s'appliquent à ce choix 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

Pour les organisations qui gèrent les pools par espace de travail, sélectionnez plutôt le pool par défaut de l'espace de travail :

bird email ip-pools workspaces assign ipp_shared ws_01krdgeqcxet5s7t44vh8rt9mg --is-default

Utilisez les affectations d'espaces de travail lorsque l'opération update --is-default au niveau de l'organisation renvoie IPPoolOrganizationDefaultRetired. Les modifications d'affectation peuvent être temporairement indisponibles pendant la transition. Modifier le pool par défaut d'un espace de travail ne change pas celui des autres espaces de travail.

• 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.

Ces vérifications protègent les modifications planifiées. Si un pool dédié perd ses IP d'envoi ou les permissions dont il a besoin, les envois via ce pool échouent jusqu'à ce que vous le rétablissiez ou choisissiez un autre pool par défaut autorisé.

Sélectionner un pool au moment de l'envoi

Le routage est la partie de cette fonctionnalité qui se trouve dans l'API publique. Choisissez un pool par message avec le champ optionnel ip_pool_id de POST /v1/email/messages :

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

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

La résolution fonctionne ainsi :

• ip_pool_id omis : l'envoi utilise le pool par défaut du domaine d'envoi dans l'espace de travail actuel, s'il est défini ; sinon, il utilise votre routage par défaut.
• ip_pool_id: "ipp_shared" : l'envoi utilise le pool partagé lorsque votre espace de travail peut l'utiliser. Cette valeur sélectionne l'infrastructure partagée même lorsqu'un pool dédié est votre pool par défaut.
• ip_pool_id défini sur un identifiant de pool : l'envoi utilise ce pool lorsqu'il est disponible pour votre espace de travail.

Une valeur inconnue, non disponible pour l'espace de travail ou désignant un pool sans IP disponible est rejetée avec une erreur 422. Un pool dédié contenant des IP en préchauffage a également besoin de la permission d'utiliser le pool partagé pour le surplus du préchauffage. Si vous retirez la permission sur le pool partagé, ce routage de préchauffage devient indisponible. Un choix de pool explicite est conservé pour les messages acceptés, puis vérifié à nouveau avant l'envoi ; un retrait de permission ultérieur peut donc bloquer la remise. Bird ne remplace pas un choix explicite indisponible par un autre pool.

Annuler une IP dédiée

L'annulation se fait en deux phases. L'annulation planifie le retrait au lieu de supprimer l'IP immédiatement :

bird email dedicated-ips delete dip_5g8r8h31kr8cz8zp1p4s837r4m --yes

L'IP passe au statut pending_cancellation et reçoit un horodatage cancels_at, correspondant à la fin de la période de facturation déjà payée. Jusqu'à cancels_at, elle continue d'envoyer dans le cadre de son pool ; après cela, nous la déprovisionnons dans l'heure. Annuler une IP déjà en attente n'a aucun effet supplémentaire.

Anticipez la conséquence immédiate : une IP pending_cancellation cesse immédiatement de compter dans les règles du pool par défaut. Et la protection du pool par défaut s'applique toujours : la dernière IP du pool par défaut ne peut pas être annulée ; déplacez d'abord le pool par défaut (vers le pool partagé ou un autre pool).

É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