# Ajouter un domaine d’envoi

> Ajoutez votre domaine à Emailit, publiez les enregistrements DNS qu’il génère, envoyez-les à un développeur si nécessaire, et vérifiez le domaine pour pouvoir envoyer.

Ce guide vous accompagne dans l’ajout d’un domaine d’envoi, la publication de ses enregistrements DNS et sa vérification. Comptez quelques minutes de travail, plus le temps que met votre fournisseur DNS à publier les enregistrements.

## Avant de commencer

- Vous devez avoir accès aux paramètres DNS du domaine, ou connaître quelqu’un qui y a accès. Vous pouvez [lui envoyer les enregistrements par e-mail](#send-the-records-to-someone-else).
- Choisissez le domaine depuis lequel vous allez envoyer. Utiliser un sous-domaine comme `mail.acme.com` sépare votre réputation d’envoi de celle de votre domaine racine. Consultez [Domaine racine ou sous-domaine ?](/fr/docs/domains/#root-domain-or-subdomain)
- Vérifiez que votre forfait permet d’ajouter un domaine de plus. Consultez [Limites de domaines](/fr/docs/domains/limits/).
- Pour l’API, utilisez une clé API **Full Access**. Les clés d’envoi uniquement ne peuvent pas gérer les domaines.

## Règles de nommage des domaines

- Saisissez le domaine nu : `acme.com` ou `mail.acme.com`. N’incluez ni `http://`, ni `https://`, ni préfixe `www.`.
- Utilisez des lettres, des chiffres, des traits d’union et des points, avec un domaine de premier niveau d’au moins deux lettres. Emailit enregistre le nom en minuscules.
- Les sous-domaines de n’importe quel niveau sont autorisés, par exemple `eu.mail.acme.com`. Chacun est un domaine distinct avec ses propres enregistrements.
- Un nom ne peut être ajouté qu’une fois par espace de travail. L’ajouter de nouveau renvoie `409 Domain with this name already exists`.

## Ajouter le domaine

**Tableau de bord**

  1. **Ouvrez Domains.** Accédez à **Email API → Domains** et sélectionnez **Add domain**.

     Si le bouton est désactivé, votre espace de travail a atteint sa limite de domaines. Le badge à côté du titre de la page indique combien vous en avez utilisé.

  2. **Saisissez le domaine.** Dans **Name**, tapez le domaine depuis lequel vous envoyez, par exemple `mail.acme.com`, et sélectionnez **Create**.

  3. **Vérifiez les enregistrements.** Emailit ouvre la page du domaine sur l’onglet **DNS Setup**. Celui-ci liste chaque enregistrement avec son type, son nom, sa valeur, sa priorité et son TTL, ainsi qu’un bouton de copie pour chaque valeur.

**API**

  Appelez [Créer un domaine](/fr/docs/api-reference/domains/create/) avec le nom du domaine.

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

  La réponse `201` contient l’`id` du domaine et un tableau `dns_records` avec tous les enregistrements à publier :

```json
{
  "object": "domain",
  "id": "dom_2kq8Vt4xLm7Rz",
  "name": "mail.acme.com",
  "verification_status": "pending",
  "manual_review_required": false,
  "spf_status": "pending",
  "dkim_status": "pending",
  "return_path_status": "pending",
  "dns_records": [
    {
      "required": true,
      "type": "MX",
      "name": "emailit.mail.acme.com",
      "value": "feedback-smtp.ffdc-1.emailit.com",
      "priority": 10,
      "ttl": "auto",
      "status": "pending",
      "error": null
    },
    {
      "required": true,
      "type": "TXT",
      "name": "emailit.mail.acme.com",
      "value": "v=spf1 include:_spf.emailit.com ~all",
      "priority": null,
      "ttl": "auto",
      "status": "pending",
      "error": null
    }
  ]
}
```

  La réponse complète liste les six enregistrements, y compris DKIM, DMARC, le suivi et la réception. Vous pouvez aussi définir ces champs facultatifs à la création du domaine :

  | Champ | Par défaut | Description |
  | --- | --- | --- |
  | `tracking_key` | `go` | Préfixe de sous-domaine pour le CNAME de suivi. Voir [Domaine de suivi personnalisé](/fr/docs/tracking/custom-tracking-domain/). |
  | `inbound_key` | `inbound` | Préfixe de sous-domaine pour l’enregistrement MX de réception. |
  | `dmarc_reports` | `false` | Ajoute l’adresse de rapport d’Emailit à l’enregistrement DMARC suggéré. Forfaits Pro, Business et Custom uniquement ; sinon `403 plan_required`. |

  `track_loads` et `track_clicks` ne peuvent pas être activés à la création d’un domaine, car le suivi nécessite d’abord un CNAME de suivi vérifié. Envoyer `true` renvoie `422`.

Il n’existe pas d’interrupteur distinct pour les e-mails sortants ou entrants. Un domaine vérifié peut envoyer, et il reçoit les e-mails entrants dès que son enregistrement MX de réception est publié. L’API accepte les indicateurs `outgoing` et `incoming` par souci de compatibilité, mais ils ne changent pas le comportement du domaine.

## Publier les enregistrements DNS

Ajoutez les enregistrements auprès de l’entreprise qui héberge le DNS de votre domaine. Il s’agit souvent de votre bureau d’enregistrement (GoDaddy, Namecheap) ou d’un service DNS (Cloudflare, Amazon Route 53).

| Enregistrement | Type | Hôte | Que faire |
| --- | --- | --- | --- |
| Return-path | MX | `emailit.<domain>` | Obligatoire. Priorité 10. |
| SPF | TXT | `emailit.<domain>` | Obligatoire. |
| DKIM | TXT | `emailit._domainkey.<domain>` | Obligatoire. Collez la valeur complète. |
| DMARC | TXT | `_dmarc.<domain>` | Recommandé. Ignorez-le si le domaine a déjà un enregistrement DMARC. |
| Suivi | CNAME | `go.<domain>` | Uniquement si vous voulez le suivi des ouvertures et des clics. |
| Réception | MX | `inbound.<domain>` | Uniquement si vous voulez recevoir des e-mails. Priorité 10. |

La plupart des fournisseurs DNS n’attendent dans le champ hôte que la partie située avant votre domaine (`emailit`, et non `emailit.acme.com`). La page [Enregistrements DNS](/fr/docs/domains/dns-records/) donne les valeurs exactes, des conseils propres à chaque fournisseur et les erreurs fréquentes.

Si votre domaine utilise le DNS de Cloudflare, la page du domaine propose **Set up with Cloudflare**, qui crée les enregistrements pour vous. Consultez [Configurer le DNS avec Cloudflare](/fr/docs/domains/cloudflare/).

## Envoyer les enregistrements à quelqu’un d’autre

Si quelqu’un d’autre gère votre DNS, envoyez-lui les enregistrements par e-mail depuis le tableau de bord.

1. **Ouvrez le domaine.** Dans **Email API → Domains**, sélectionnez le domaine.

2. **Sélectionnez Send to email.** Ce bouton se trouve en haut à droite de la carte **DNS Setup**.

3. **Saisissez son adresse.** Dans **Recipient Email**, tapez l’adresse de votre développeur ou de votre administrateur informatique et sélectionnez **Send Instructions**.

Cette personne reçoit un e-mail d’Emailit contenant chaque enregistrement et sa valeur. Demandez-lui de vous prévenir quand les enregistrements sont publiés pour que vous puissiez lancer la vérification.

## Vérifier le DNS et le domaine

**Tableau de bord**

  Sur la page du domaine, sélectionnez **Check DNS**. Emailit recherche chaque enregistrement et met à jour le statut affiché à côté : **OK**, **Missing**, **Invalid** ou **Not checked**. Survolez **Missing** ou **Invalid** pour voir ce qu’Emailit a trouvé.

**API**

  Appelez [Vérifier un domaine](/fr/docs/api-reference/domains/verify/). Vous pouvez utiliser l’ID du domaine ou son nom.

```bash
curl https://api.emailit.com/v2/domains/mail.acme.com/verify \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

  La réponse contient le domaine mis à jour. Vérifiez `verification_status` ainsi que le `status` et l’`error` de chaque élément de `dns_records`.

> **La vérification ne s’exécute qu’à votre demande:** Emailit ne vérifie pas de lui-même un nouveau domaine. Après avoir publié ou corrigé des enregistrements, relancez **Check DNS**. Les modifications DNS apparaissent généralement en quelques minutes, mais certains fournisseurs mettent jusqu’à 48 heures.

Le domaine est vérifié quand SPF, DKIM et le return-path affichent tous **OK**. DMARC, le suivi et la réception sont facultatifs et n’affectent pas la vérification.

## Vérifier le résultat

- Le domaine affiche **Verified** dans **Email API → Domains**, et les colonnes **SPF**, **DKIM** et **Return Path** affichent **OK**.
- Envoyez un message de test depuis une adresse du domaine. Sur la page **Emails**, sélectionnez **Compose**, ou appelez [Envoyer un e-mail](/fr/docs/api-reference/emails/send/).

Si le domaine affiche **Pending verification**, il attend un examen manuel. Cela concerne les domaines Pay as you go enregistrés depuis moins de 30 jours. Consultez [Vérification des domaines](/fr/docs/domains/verification/#pending-verification).

> **Remarque:** Un domaine vérifié ne lève pas le mode bac à sable. Tant que votre espace de travail n’a pas l’accès production, vous ne pouvez envoyer qu’aux adresses e-mail des comptes des membres de l’espace de travail. Consultez [Accès production](/fr/docs/workspaces/production-access/).

## Dépannage

| Problème | Solution |
| --- | --- |
| **Add domain** est désactivé | Vous avez atteint la limite de domaines de votre forfait. Supprimez un domaine inutilisé ou relevez la limite. Voir [Limites de domaines](/fr/docs/domains/limits/). |
| `The domain must be in apex format` | Retirez `http://`, `https://` ou `www.` et assurez-vous que le nom se termine par un vrai domaine de premier niveau. |
| Les enregistrements affichent **Missing** au bout d’une heure | L’hôte est probablement doublé, par exemple `emailit.acme.com.acme.com`. Saisissez uniquement `emailit` dans le champ hôte. |
| DKIM affiche **Invalid** | Une partie de la valeur a été tronquée. Copiez-la de nouveau avec le bouton de copie. |

La page [Vérification des domaines](/fr/docs/domains/verification/#troubleshooting) couvre d’autres cas.

## Voir aussi

  - [Enregistrements DNS](/fr/docs/domains/dns-records/): Référence de tous les enregistrements générés par Emailit.
  - [Vérification des domaines](/fr/docs/domains/verification/): Statuts, examen manuel et revérifications quotidiennes.
  - [Domaine de suivi personnalisé](/fr/docs/tracking/custom-tracking-domain/): Configurez le suivi des ouvertures et des clics.
  - [Configurer la réception des e-mails](/fr/docs/inbound/set-up/): Recevez des e-mails sur votre domaine.

---
Source: https://emailit.com/fr/docs/domains/add-a-domain/