# Événements de domaine > Domaines d’envoi créés, mis à jour ou supprimés. ## domain.created > Envoyé lorsqu’un domaine d’envoi est ajouté à l’espace de travail. Contient les enregistrements DNS à publier, tous avec le statut pending. # domain.created Envoyé lorsqu’un domaine d’envoi est ajouté à l’espace de travail, par exemple avec [Créer un domaine](/fr/docs/api-reference/domains/create/). Le payload contient les enregistrements DNS à publier ; ils sont tous d’abord à `pending`. Consultez [Ajouter un domaine](/fr/docs/domains/add-a-domain/). Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez [Requêtes de webhook](/fr/docs/webhooks/webhook-requests/). ```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 } ] } } } ``` ## Champs - `event_id` (string): 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](/fr/docs/api-reference/events/get/). - `type` (string): Toujours `domain.created`. - `object` (object): Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous. - `data.object` (object): Le même objet, sous la forme que l’[API des événements](/fr/docs/api-reference/events/get/) renvoie dans `data`. ### Objet domaine - `id` (string): ID du domaine (`dom_…`). - `object` (string): Toujours `domain`. - `name` (string): Nom de domaine, par exemple `acme.com`. - `tracking_key` (string | null): Sous-domaine personnalisé du CNAME de suivi, ou `null` pour la valeur par défaut `go`. - `inbound_key` (string | null): Sous-domaine personnalisé de l’enregistrement MX de réception, ou `null` pour la valeur par défaut `inbound`. - `track_loads` (boolean): Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine. - `track_clicks` (boolean): Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine. - `created_at` (string): Date d’ajout du domaine, au format ISO 8601 avec décalage UTC. - `dns_records` (object[]): Enregistrements DNS du domaine. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/). - `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` ou `CNAME`. - `dns_records[].name` (string): Nom d’hôte de l’enregistrement. - `dns_records[].value` (string): Valeur à publier. - `dns_records[].priority` (integer | null): Priorité MX, ou `null` pour les autres types. - `dns_records[].ttl` (string): Toujours `auto`. - `dns_records[].status` (string): Résultat de la dernière vérification DNS : `pending`, `ok`, `missing` ou `invalid`. - `dns_records[].error` (string | null): Raison de l’échec de la dernière vérification, ou `null`. --- Source: https://emailit.com/fr/docs/webhooks/events/domain/domain-created/ ## domain.updated > Envoyé lorsque les paramètres d’un domaine d’envoi changent, comme les options de suivi ou de réception. Les vérifications ne le déclenchent pas. # 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](/fr/docs/api-reference/domains/update/) 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](/fr/docs/api-reference/domains/get/) 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](/fr/docs/webhooks/webhook-requests/). ```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 } ] } } } ``` ## Champs - `event_id` (string): 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](/fr/docs/api-reference/events/get/). - `type` (string): Toujours `domain.updated`. - `object` (object): Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous. - `data.object` (object): Le même objet, sous la forme que l’[API des événements](/fr/docs/api-reference/events/get/) renvoie dans `data`. ### Objet domaine - `id` (string): ID du domaine (`dom_…`). - `object` (string): Toujours `domain`. - `name` (string): Nom de domaine, par exemple `acme.com`. - `verified_at` (string | null): Date de vérification du domaine, ou `null` s’il n’est pas vérifié. - `tracking_key` (string | null): Sous-domaine personnalisé du CNAME de suivi, ou `null` pour la valeur par défaut `go`. - `inbound_key` (string | null): Sous-domaine personnalisé de l’enregistrement MX de réception, ou `null` pour la valeur par défaut `inbound`. - `track_loads` (boolean): Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine. - `track_clicks` (boolean): Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine. - `dns_checked_at` (string | null): Date de la dernière vérification des enregistrements DNS par Emailit. - `created_at` (string): Date d’ajout du domaine, au format ISO 8601 avec décalage UTC. - `dns_records` (object[]): Enregistrements DNS du domaine. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/). - `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` ou `CNAME`. - `dns_records[].name` (string): Nom d’hôte de l’enregistrement. - `dns_records[].value` (string): Valeur à publier. - `dns_records[].priority` (integer | null): Priorité MX, ou `null` pour les autres types. - `dns_records[].ttl` (string): Toujours `auto`. - `dns_records[].status` (string): Résultat de la dernière vérification DNS : `pending`, `ok`, `missing` ou `invalid`. - `dns_records[].error` (string | null): Raison de l’échec de la dernière vérification, ou `null`. --- Source: https://emailit.com/fr/docs/webhooks/events/domain/domain-updated/ ## domain.deleted > Envoyé lorsqu’un domaine d’envoi est supprimé de l’espace de travail. Le payload correspond au domaine tel qu’il était avant sa suppression. # domain.deleted Envoyé lorsqu’un domaine d’envoi est supprimé, par exemple avec [Supprimer un domaine](/fr/docs/api-reference/domains/delete/). 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](/fr/docs/webhooks/webhook-requests/). ```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 } ] } } } ``` ## Champs - `event_id` (string): 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](/fr/docs/api-reference/events/get/). - `type` (string): Toujours `domain.deleted`. - `object` (object): Le domaine décrit par l’événement. Ses champs sont détaillés ci-dessous. - `data.object` (object): Le même objet, sous la forme que l’[API des événements](/fr/docs/api-reference/events/get/) renvoie dans `data`. ### Objet domaine - `id` (string): ID du domaine (`dom_…`). - `object` (string): Toujours `domain`. - `name` (string): Nom de domaine, par exemple `acme.com`. - `verified_at` (string | null): Date de vérification du domaine, ou `null` s’il n’est pas vérifié. - `tracking_key` (string | null): Sous-domaine personnalisé du CNAME de suivi, ou `null` pour la valeur par défaut `go`. - `inbound_key` (string | null): Sous-domaine personnalisé de l’enregistrement MX de réception, ou `null` pour la valeur par défaut `inbound`. - `track_loads` (boolean): Indique si le suivi des ouvertures est activé par défaut pour les e-mails de ce domaine. - `track_clicks` (boolean): Indique si le suivi des clics est activé par défaut pour les e-mails de ce domaine. - `dns_checked_at` (string | null): Date de la dernière vérification des enregistrements DNS par Emailit. - `created_at` (string): Date d’ajout du domaine, au format ISO 8601 avec décalage UTC. - `dns_records` (object[]): Enregistrements DNS du domaine. Consultez [Enregistrements DNS](/fr/docs/domains/dns-records/). - `dns_records[].required` (boolean): `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[].type` (string): `MX`, `TXT` ou `CNAME`. - `dns_records[].name` (string): Nom d’hôte de l’enregistrement. - `dns_records[].value` (string): Valeur à publier. - `dns_records[].priority` (integer | null): Priorité MX, ou `null` pour les autres types. - `dns_records[].ttl` (string): Toujours `auto`. - `dns_records[].status` (string): Résultat de la dernière vérification DNS : `pending`, `ok`, `missing` ou `invalid`. - `dns_records[].error` (string | null): Raison de l’échec de la dernière vérification, ou `null`. --- Source: https://emailit.com/fr/docs/webhooks/events/domain/domain-deleted/