Recevoir votre premier e-mail entrant

Ce démarrage rapide configure un domaine pour recevoir des e-mails, afin que votre application puisse traiter les réponses, les demandes de support ou les messages transférés. Vous allez ajouter un enregistrement DNS, envoyer un message de test, puis le recevoir avec un webhook et récupérer son contenu complet via l’API.

Avant de commencer

• Un domaine d’envoi vérifié, comme acme.com. La réception ne fonctionne que sur les domaines vérifiés dans votre espace de travail. Consultez Ajouter un domaine d’envoi.
• Des crédits dans l’espace de travail. Chaque e-mail reçu coûte 1 crédit.

Fonctionnement des adresses de réception

Emailit reçoit les e-mails sur un sous-domaine de votre domaine d’envoi, inbound par défaut. Toute adresse de ce sous-domaine fonctionne : support@inbound.acme.com et reply-4821@inbound.acme.com arrivent donc dans le même espace de travail. Les enregistrements MX de votre domaine principal, par exemple pour Google Workspace ou Microsoft 365, restent inchangés.

Ajouter l’enregistrement MX de réception

1. Ouvrez le domaine. Accédez à Email API›Domains et ouvrez acme.com. L’enregistrement MX de inbound.acme.com figure avec les autres enregistrements DNS. Il est facultatif : le domaine reste vérifié sans lui.

2. Ajoutez l’enregistrement chez votre fournisseur DNS.

   Type	Nom	Valeur	Priorité
   MX	inbound.acme.com	inbound.emailitmail.com	10

   Certains fournisseurs DNS n’acceptent que inbound dans le champ du nom. D’autres demandent le nom complet.

3. Vérifiez le DNS. Sélectionnez Check DNS sur la page du domaine et attendez que l’enregistrement de réception affiche OK. Les modifications DNS prennent généralement quelques minutes, mais peuvent prendre jusqu’à 48 heures.

Pour recevoir sur un autre sous-domaine, comme replies.acme.com, définissez inbound_key sur replies lorsque vous créez ou mettez à jour le domaine avec l’API, puis publiez l’enregistrement MX pour ce nom. Le tableau de bord affiche le sous-domaine de réception, mais ne permet pas de le modifier.

Envoyer un e-mail de test

Depuis votre messagerie personnelle, envoyez un e-mail à n’importe quelle adresse du sous-domaine de réception, par exemple hello@inbound.acme.com.

Accédez à Email API›Emails et ouvrez l’onglet Incoming. Le message apparaît avec le statut received. Ouvrez-le pour voir l’expéditeur, les en-têtes, le contenu et les éventuelles pièces jointes.

S’il n’arrive pas, vérifiez que l’enregistrement MX affiche OK et que le domaine est vérifié. Si l’espace de travail n’a plus de crédits, Emailit refuse le message avec une erreur temporaire, et le serveur de l’expéditeur réessaie plus tard.

Être notifié par webhook

Pour traiter les e-mails entrants dans votre application, abonnez-vous à l’événement email.received.

1. Créez le webhook. Accédez à Email API›Webhooks, sélectionnez Add webhook, puis saisissez un nom et votre endpoint HTTPS, par exemple https://acme.com/webhooks/emailit. Copiez le secret du webhook : vous en avez besoin pour vérifier les signatures.

2. Choisissez l’événement. Un nouveau webhook reçoit tous les événements. Ouvrez l’onglet Settings du webhook et sélectionnez uniquement email.received, ou conservez tous les événements et filtrez-les dans votre code.

3. Envoyez un autre e-mail de test à hello@inbound.acme.com.

Emailit envoie une requête POST signée à votre endpoint. Le corps est un tableau JSON, car une requête peut contenir jusqu’à 100 événements :

[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]

L’événement contient l’expéditeur, le destinataire et l’objet, mais pas le corps. Vérifiez l’en-tête X-Emailit-Signature avant de vous fier à la requête. Consultez Signature des requêtes.

Récupérer l’e-mail complet

Utilisez l’id de l’événement pour récupérer le message avec une clé API Full Access :

curl https://api.emailit.com/v2/emails/em_2pXb7Kq4NvL8mWc3RtB9yZd \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

La réponse contient les en-têtes analysés, le corps texte et HTML, et les pièces jointes :

{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}

Pour obtenir plutôt le message d’origine, appelez GET /emails/{id}/raw. Le contenu des messages est conservé pendant la durée de conservation de votre forfait : récupérez-le donc peu après l’arrivée de l’événement. Consultez Conservation des données.

Tarifs

Chaque e-mail reçu coûte 1 crédit, comme un e-mail envoyé. Consultez Crédits.

Étapes suivantes