---
title: Domaines
description: Vérifiez un domaine d'envoi, ajoutez ses enregistrements DNS et configurez-le pour le suivi, la réception et le préchauffage.
seo:
  title: Configurer un domaine d'envoi
ai:
  exclude: true
---

Chaque e-mail doit être envoyé depuis un domaine que votre équipe a vérifié. Toute autre adresse `from` est refusée avec `422`. Ajoutez et vérifiez vos domaines dans le tableau de bord, sous **Domaines**, ou avec l'API.

## Ajouter et vérifier un domaine

```bash
curl -X POST https://api.billionsend.com/domains \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "mail.example.com" }'
```

La réponse liste les enregistrements DNS à ajouter chez votre fournisseur DNS. Un sous-domaine comme `mail.example.com` est un bon choix de domaine d'envoi. Une fois les enregistrements en ligne, cliquez sur **Vérifier** sur la page du domaine ou appelez `POST /domains/{id}/verify`.

| Enregistrement | Rôle |
| --- | --- |
| DKIM (deux CNAME, `bs1._domainkey` et `bs2._domainkey`) | Signe vos e-mails pour que les fournisseurs sachent qu'ils viennent de vous. |
| MAIL FROM (MX et TXT) | Une adresse de rebond sur votre propre domaine, pour que SPF soit aligné. |
| DMARC (TXT, recommandé) | Indique aux fournisseurs quoi faire des e-mails qui échouent aux vérifications. Il ne bloque pas l'envoi. |

DKIM et MAIL FROM doivent être vérifiés avant de pouvoir envoyer. Sur Cloudflare, laissez ces enregistrements en **DNS uniquement** (nuage gris).

La page du domaine affiche chaque enregistrement comme trouvé, manquant ou non conforme, vérifié en direct sur le DNS public. `GET /domains/{id}` renvoie la même chose dans `records[]`. Chaque enregistrement a un `status` (`not_started`, `pending`, `verified` ou `failed`), une valeur `live` pour ce que le DNS public répond à l'instant, et un court `detail` quand quelque chose ne va pas.

### Les clés DKIM sont renouvelées automatiquement

BillionSend crée une clé DKIM pour chaque domaine et la remplace tous les 180 jours, en alternant entre les deux CNAME. Vous ajoutez les enregistrements une fois et n'y touchez plus. Vous pouvez désactiver la rotation automatique dans l'onglet **Paramètres** du domaine.

### Région

`POST /domains` accepte un `region` facultatif. Un domaine vit dans une seule région. Pour le déplacer, supprimez-le et ajoutez-le de nouveau dans l'autre région ; ses enregistrements DNS changent.

### Limites du forfait

| | Free | Starter | Pro et Scale |
| --- | --- | --- | --- |
| Domaines d'envoi par équipe | 3 | 10 | Illimité |

Au-delà de la limite, `POST /domains` répond `403 plan_limit_reached`. Un nom de domaine qu'une autre équipe possède déjà répond `409`.

## Préchauffage d'un nouveau domaine

Un domaine récemment enregistré envoie à un volume quotidien limité pendant qu'il se construit une réputation. Le plafond dépend de l'âge du domaine enregistré (`example.com` pour `mail.example.com`) et se compte par jour UTC :

| Âge du domaine | E-mails par jour |
| --- | --- |
| Moins de 1 jour | 100 |
| 1 jour à moins de 7 jours | 300 |
| 7 jours à moins de 30 jours | 2 000 |
| 30 jours ou plus | Uniquement la limite de votre forfait |

- Un domaine qui envoie proprement, avec peu de rebonds et aucune plainte, passe plus tôt à l'étape suivante.
- Le plafond s'applique en plus de votre forfait. Passer à un forfait supérieur ne le lève pas.
- Vos nouveaux domaines partagent un seul volume quotidien : ajouter un autre nouveau domaine n'ajoute pas de volume.
- Les e-mails au-delà du plafond ne sont pas perdus. Ils apparaissent comme **En attente** et partent le lendemain, les plus anciens d'abord. Si beaucoup d'e-mails attendent déjà, un envoi répond `429 daily_quota_exceeded` ; réessayez après le changement de jour UTC.

La page du domaine affiche « Préchauffage : N/jour aujourd'hui » tant qu'un plafond s'applique. Voir [Limites d'envoi](/docs/fr/concepts/sending-limits) pour toutes les protections de l'envoi.

## Paramètres

Une fois un domaine vérifié, ces paramètres sont disponibles :

- **Suivi des ouvertures et des clics.** Les deux sont désactivés par défaut. Activez-les dans l'onglet **Liens** du domaine, ou avec `open_tracking` et `click_tracking` sur `PATCH /domains/{id}`. Voir [Suivi](/docs/fr/concepts/tracking).
- **Sous-domaines propres de suivi et de désinscription.** Servez les liens suivis et les liens de désinscription depuis votre propre domaine. Un forfait payant est requis. Voir [Suivi](/docs/fr/concepts/tracking).
- **Page de désinscription.** L'apparence de la page que voient vos destinataires : nom, logo, couleurs et textes. Définissez-la dans l'onglet **Marque** du domaine, ou avec `unsubscribe_page` sur `PATCH /domains/{id}`. Voir [Désinscriptions](/docs/fr/concepts/unsubscribes).
- **TLS obligatoire.** Ne livrer qu'aux serveurs qui prennent en charge TLS. Définissez-le dans l'onglet **Paramètres**.
- **Nom d'expéditeur, adresse d'expéditeur et reply-to par défaut.** Définissez-les dans l'onglet **Paramètres**.

## Réception

Un domaine vérifié peut aussi [recevoir des e-mails](/docs/fr/receiving). Activez la réception avec **Activer la réception** sur la page du domaine, ou avec `PATCH /domains/{id}` :

```json
{ "capabilities": { "receiving": "enabled" } }
```

- Seul un domaine vérifié peut activer la réception. `POST /domains` avec `"receiving": "enabled"` répond `422` : ajoutez le domaine, vérifiez-le, puis activez la réception.
- L'activer ajoute deux enregistrements `Receiving` : des enregistrements MX qui pointent vers `mx1.billionsend-dns.com` et `mx2.billionsend-dns.com`, tous deux avec la priorité `10`. Publiez les deux, pour qu'un expéditeur qui trouve l'un hors service réessaie sur l'autre. Ils n'affectent pas l'envoi. Si le domaine reçoit déjà des e-mails ailleurs, placez les enregistrements MX sur un sous-domaine comme `inbound.example.com`, car un enregistrement MX de numéro inférieur prendrait les e-mails à sa place.
- Un nom ne peut recevoir que dans une seule équipe. Un nom sur lequel une autre équipe reçoit déjà répond `409`.
- Par défaut, seules les adresses de vos [boîtes de réception](/docs/fr/inboxes) reçoivent des e-mails. **Catch-all** accepte toutes les adresses du domaine. Il exige un forfait payant et se règle dans le tableau de bord ou avec `receiving_catch_all` sur `PATCH /domains/{id}`.

## Sous-domaine partagé

Chaque équipe reçoit aussi un sous-domaine sur un domaine partagé de BillionSend, où ses [boîtes de réception](/docs/fr/inboxes) partagées obtiennent leurs adresses. Il apparaît à la fin de `GET /domains` avec `shared: true`. Il est déjà vérifié et en lecture seule : `PATCH`, la vérification et `DELETE` répondent `403 forbidden`, et il ne compte pas dans votre limite de domaines. Il ne peut envoyer que depuis les adresses propres de vos boîtes de réception.

## Supprimer un domaine

`DELETE /domains/{id}`, ou **Supprimer** sur la page du domaine, est refusé avec `409` dans deux cas :

- Une [thématique](/docs/fr/concepts/topics) ou un [segment](/docs/fr/concepts/segments) est lié au domaine. Supprimez-le, ou mettez son `domain_id` à `null`.
- Une [campagne](/docs/fr/concepts/broadcasts) programmée ou en cours d'envoi utilise le domaine. Annulez-la, ou attendez qu'elle soit partie.

Supprimer un domaine supprime aussi ses boîtes de réception. Les [désinscriptions](/docs/fr/concepts/unsubscribes) des destinataires de ce domaine sont conservées, et s'appliquent de nouveau si vous rajoutez le même nom.

## Clés API et domaines

Une clé API peut être limitée à un seul domaine. Une telle clé ne peut envoyer que depuis ce domaine, et tout autre `from` répond `403 restricted_api_key`. Elle ne lit que les e-mails reçus sur ce domaine, ne voit et ne modifie que ce domaine sous `/domains` (tout autre domaine répond `404`), et les clés qu'elle crée sont limitées au même domaine. Les webhooks, les suppressions, les templates et le reste de ce qui appartient à toute l'équipe répondent `403 restricted_api_key` ; la page [Clés API](/docs/fr/api-keys) les liste. Une clé peut aussi être limitée à une seule [boîte de réception](/docs/fr/inboxes).
