Événements de domaine

Domaines d’envoi créés, mis à jour ou supprimés.

domain.created
domain.updated
domain.deleted

domain.created

Envoyé lorsqu’un domaine d’envoi est ajouté à l’espace de travail, par exemple avec Créer un domaine. Le payload contient les enregistrements DNS à publier ; ils sont tous d’abord à pending. Consultez Ajouter un domaine.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours domain.created.

objectobject

Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet domaine

idstring

ID du domaine (dom_…).

objectstring

Toujours domain.

namestring

Nom de domaine, par exemple acme.com.

tracking_keystring | null

Sous-domaine personnalisé du CNAME de suivi, ou null pour la valeur par défaut go.

inbound_keystring | null

Sous-domaine personnalisé de l’enregistrement MX de réception, ou null pour la valeur par défaut inbound.

track_loadsboolean

Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine.

track_clicksboolean

Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine.

created_atstring

Date d’ajout du domaine, au format ISO 8601 avec décalage UTC.

dns_recordsobject[]

Enregistrements DNS du domaine. Consultez Enregistrements DNS.

dns_records[].requiredboolean

true pour les enregistrements MX du return-path, SPF et DKIM, nécessaires à la vérification. Les enregistrements DMARC, de suivi et de réception sont facultatifs.

dns_records[].typestring

MX, TXT ou CNAME.

dns_records[].namestring

Nom d’hôte de l’enregistrement.

dns_records[].valuestring

Valeur à publier.

dns_records[].priorityinteger | null

Priorité MX, ou null pour les autres types.

dns_records[].ttlstring

Toujours auto.

dns_records[].statusstring

Résultat de la dernière vérification DNS : pending, ok, missing ou invalid.

dns_records[].errorstring | null

Raison de l’échec de la dernière vérification, ou null.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.created",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": false,
    "track_clicks": false,
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": false,
      "track_clicks": false,
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}

domain.updated

Envoyé lorsque les paramètres d’un domaine changent, par exemple ses options de suivi ou de réception, avec Mettre à jour un domaine ou dans le tableau de bord. Les vérifications DNS et la vérification du domaine ne déclenchent pas cet événement ; utilisez Récupérer un domaine pour suivre le statut de vérification.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

typestring

Toujours domain.updated.

objectobject

Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet domaine

idstring

ID du domaine (dom_…).

objectstring

Toujours domain.

namestring

Nom de domaine, par exemple acme.com.

verified_atstring | null

Date de vérification du domaine, ou null s’il n’est pas vérifié.

tracking_keystring | null

Sous-domaine personnalisé du CNAME de suivi, ou null pour la valeur par défaut go.

inbound_keystring | null

Sous-domaine personnalisé de l’enregistrement MX de réception, ou null pour la valeur par défaut inbound.

track_loadsboolean

Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine.

track_clicksboolean

Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine.

dns_checked_atstring | null

Date de la dernière vérification des enregistrements DNS par Emailit.

created_atstring

Date d’ajout du domaine, au format ISO 8601 avec décalage UTC.

dns_recordsobject[]

Enregistrements DNS du domaine. Consultez Enregistrements DNS.

dns_records[].requiredboolean

true pour les enregistrements MX du return-path, SPF et DKIM, nécessaires à la vérification. Les enregistrements DMARC, de suivi et de réception sont facultatifs.

dns_records[].typestring

MX, TXT ou CNAME.

dns_records[].namestring

Nom d’hôte de l’enregistrement.

dns_records[].valuestring

Valeur à publier.

dns_records[].priorityinteger | null

Priorité MX, ou null pour les autres types.

dns_records[].ttlstring

Toujours auto.

dns_records[].statusstring

Résultat de la dernière vérification DNS : pending, ok, missing ou invalid.

dns_records[].errorstring | null

Raison de l’échec de la dernière vérification, ou null.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.updated",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}

domain.deleted

Envoyé lorsqu’un domaine d’envoi est supprimé, par exemple avec Supprimer un domaine. Le payload correspond au domaine tel qu’il était avant sa suppression.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

typestring

Toujours domain.deleted.

objectobject

Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet domaine

idstring

ID du domaine (dom_…).

objectstring

Toujours domain.

namestring

Nom de domaine, par exemple acme.com.

verified_atstring | null

Date de vérification du domaine, ou null s’il n’est pas vérifié.

tracking_keystring | null

Sous-domaine personnalisé du CNAME de suivi, ou null pour la valeur par défaut go.

inbound_keystring | null

Sous-domaine personnalisé de l’enregistrement MX de réception, ou null pour la valeur par défaut inbound.

track_loadsboolean

Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine.

track_clicksboolean

Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine.

dns_checked_atstring | null

Date de la dernière vérification des enregistrements DNS par Emailit.

created_atstring

Date d’ajout du domaine, au format ISO 8601 avec décalage UTC.

dns_recordsobject[]

Enregistrements DNS du domaine. Consultez Enregistrements DNS.

dns_records[].requiredboolean

true pour les enregistrements MX du return-path, SPF et DKIM, nécessaires à la vérification. Les enregistrements DMARC, de suivi et de réception sont facultatifs.

dns_records[].typestring

MX, TXT ou CNAME.

dns_records[].namestring

Nom d’hôte de l’enregistrement.

dns_records[].valuestring

Valeur à publier.

dns_records[].priorityinteger | null

Priorité MX, ou null pour les autres types.

dns_records[].ttlstring

Toujours auto.

dns_records[].statusstring

Résultat de la dernière vérification DNS : pending, ok, missing ou invalid.

dns_records[].errorstring | null

Raison de l’échec de la dernière vérification, ou null.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "domain.deleted",
  "object": {
    "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
    "object": "domain",
    "name": "acme.com",
    "verified_at": "2026-09-28T08:40:19.226000+00:00",
    "tracking_key": null,
    "inbound_key": null,
    "track_loads": true,
    "track_clicks": true,
    "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
    "created_at": "2026-09-28T08:31:52.690000+00:00",
    "dns_records": [
      {
        "required": true,
        "type": "MX",
        "name": "emailit.acme.com",
        "value": "feedback-smtp.ffdc-1.emailit.com",
        "priority": 10,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit.acme.com",
        "value": "v=spf1 include:_spf.emailit.com ~all",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": true,
        "type": "TXT",
        "name": "emailit._domainkey.acme.com",
        "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
        "priority": null,
        "ttl": "auto",
        "status": "ok",
        "error": null
      },
      {
        "required": false,
        "type": "TXT",
        "name": "_dmarc.acme.com",
        "value": "v=DMARC1; p=none;",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "CNAME",
        "name": "go.acme.com",
        "value": "go.emailitmail.com",
        "priority": null,
        "ttl": "auto",
        "status": "pending",
        "error": null
      },
      {
        "required": false,
        "type": "MX",
        "name": "inbound.acme.com",
        "value": "inbound.emailitmail.com",
        "priority": 10,
        "ttl": "auto",
        "status": "pending",
        "error": null
      }
    ]
  },
  "data": {
    "object": {
      "id": "dom_2xLh4Dy9Ts6Zp1Ve3Ao8Lf5Mu0h",
      "object": "domain",
      "name": "acme.com",
      "verified_at": "2026-09-28T08:40:19.226000+00:00",
      "tracking_key": null,
      "inbound_key": null,
      "track_loads": true,
      "track_clicks": true,
      "dns_checked_at": "2026-10-01T03:00:07.512000+00:00",
      "created_at": "2026-09-28T08:31:52.690000+00:00",
      "dns_records": [
        {
          "required": true,
          "type": "MX",
          "name": "emailit.acme.com",
          "value": "feedback-smtp.ffdc-1.emailit.com",
          "priority": 10,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit.acme.com",
          "value": "v=spf1 include:_spf.emailit.com ~all",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": true,
          "type": "TXT",
          "name": "emailit._domainkey.acme.com",
          "value": "v=DKIM1; t=s; h=sha256; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAu4Vd1kQ…IDAQAB;",
          "priority": null,
          "ttl": "auto",
          "status": "ok",
          "error": null
        },
        {
          "required": false,
          "type": "TXT",
          "name": "_dmarc.acme.com",
          "value": "v=DMARC1; p=none;",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "CNAME",
          "name": "go.acme.com",
          "value": "go.emailitmail.com",
          "priority": null,
          "ttl": "auto",
          "status": "pending",
          "error": null
        },
        {
          "required": false,
          "type": "MX",
          "name": "inbound.acme.com",
          "value": "inbound.emailitmail.com",
          "priority": 10,
          "ttl": "auto",
          "status": "pending",
          "error": null
        }
      ]
    }
  }
}