# Eventi dei domini

> Domini di invio creati, aggiornati o eliminati.



## domain.created

> Inviato quando viene aggiunto un dominio di invio al workspace. Include i record DNS da pubblicare, tutti con stato pending.

# domain.created

Inviato quando viene aggiunto un dominio di invio al workspace, ad esempio con [Crea un dominio](/it/docs/api-reference/domains/create/). Il payload include i record DNS da pubblicare, che partono tutti come `pending`. Vedi [Aggiungi un dominio](/it/docs/domains/add-a-domain/).

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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
        }
      ]
    }
  }
}
```

## Campi

- `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.created`.

- `object` (object): Il dominio descritto dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto dominio

- `id` (string): ID del dominio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome del dominio, ad esempio `acme.com`.

- `tracking_key` (string | null): Sottodominio personalizzato per il CNAME di tracciamento, oppure `null` per il valore predefinito `go`.

- `inbound_key` (string | null): Sottodominio personalizzato per il record MX di ricezione, oppure `null` per il valore predefinito `inbound`.

- `track_loads` (boolean): Indica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.

- `track_clicks` (boolean): Indica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.

- `created_at` (string): Quando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.

- `dns_records` (object[]): Record DNS del dominio. Vedi [Record DNS](/it/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` per i record MX del return path, SPF e DKIM, necessari per la verifica. I record DMARC, di tracciamento e di ricezione sono facoltativi.

- `dns_records[].type` (string): `MX`, `TXT` o `CNAME`.

- `dns_records[].name` (string): Nome host del record.

- `dns_records[].value` (string): Valore da pubblicare.

- `dns_records[].priority` (integer | null): Priorità MX, oppure `null` per gli altri tipi.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Esito dell’ultimo controllo DNS: `pending`, `ok`, `missing` o `invalid`.

- `dns_records[].error` (string | null): Perché l’ultimo controllo non è riuscito, oppure `null`.

---
Fonte: https://emailit.com/it/docs/webhooks/events/domain/domain-created/

## domain.updated

> Inviato quando cambiano le impostazioni di un dominio di invio, come il tracciamento o le opzioni di ricezione. I controlli di verifica non lo generano.

# domain.updated

Inviato quando cambiano le impostazioni di un dominio, ad esempio il tracciamento o le opzioni di ricezione, con [Aggiorna un dominio](/it/docs/api-reference/domains/update/) o nel pannello. I controlli DNS e la verifica non generano questo evento; per seguire lo stato di verifica usa [Recupera un dominio](/it/docs/api-reference/domains/get/).

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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
        }
      ]
    }
  }
}
```

## Campi

- `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.updated`.

- `object` (object): Il dominio descritto dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto dominio

- `id` (string): ID del dominio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome del dominio, ad esempio `acme.com`.

- `verified_at` (string | null): Quando è stato verificato il dominio, oppure `null` se non è verificato.

- `tracking_key` (string | null): Sottodominio personalizzato per il CNAME di tracciamento, oppure `null` per il valore predefinito `go`.

- `inbound_key` (string | null): Sottodominio personalizzato per il record MX di ricezione, oppure `null` per il valore predefinito `inbound`.

- `track_loads` (boolean): Indica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.

- `track_clicks` (boolean): Indica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.

- `dns_checked_at` (string | null): Quando Emailit ha controllato l’ultima volta i record DNS.

- `created_at` (string): Quando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.

- `dns_records` (object[]): Record DNS del dominio. Vedi [Record DNS](/it/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` per i record MX del return path, SPF e DKIM, necessari per la verifica. I record DMARC, di tracciamento e di ricezione sono facoltativi.

- `dns_records[].type` (string): `MX`, `TXT` o `CNAME`.

- `dns_records[].name` (string): Nome host del record.

- `dns_records[].value` (string): Valore da pubblicare.

- `dns_records[].priority` (integer | null): Priorità MX, oppure `null` per gli altri tipi.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Esito dell’ultimo controllo DNS: `pending`, `ok`, `missing` o `invalid`.

- `dns_records[].error` (string | null): Perché l’ultimo controllo non è riuscito, oppure `null`.

---
Fonte: https://emailit.com/it/docs/webhooks/events/domain/domain-updated/

## domain.deleted

> Inviato quando viene eliminato un dominio di invio dal workspace. Il payload è il dominio com’era prima dell’eliminazione.

# domain.deleted

Inviato quando viene eliminato un dominio di invio, ad esempio con [Elimina un dominio](/it/docs/api-reference/domains/delete/). Il payload è il dominio com’era prima di essere eliminato.

Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/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
        }
      ]
    }
  }
}
```

## Campi

- `event_id` (string): ID dell’evento (`evt_…`). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con [Recupera un evento](/it/docs/api-reference/events/get/).

- `type` (string): Sempre `domain.deleted`.

- `object` (object): Il dominio descritto dall’evento. I suoi campi sono elencati qui sotto.

- `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`.

### Oggetto dominio

- `id` (string): ID del dominio (`dom_…`).

- `object` (string): Sempre `domain`.

- `name` (string): Nome del dominio, ad esempio `acme.com`.

- `verified_at` (string | null): Quando è stato verificato il dominio, oppure `null` se non è verificato.

- `tracking_key` (string | null): Sottodominio personalizzato per il CNAME di tracciamento, oppure `null` per il valore predefinito `go`.

- `inbound_key` (string | null): Sottodominio personalizzato per il record MX di ricezione, oppure `null` per il valore predefinito `inbound`.

- `track_loads` (boolean): Indica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.

- `track_clicks` (boolean): Indica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.

- `dns_checked_at` (string | null): Quando Emailit ha controllato l’ultima volta i record DNS.

- `created_at` (string): Quando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.

- `dns_records` (object[]): Record DNS del dominio. Vedi [Record DNS](/it/docs/domains/dns-records/).

- `dns_records[].required` (boolean): `true` per i record MX del return path, SPF e DKIM, necessari per la verifica. I record DMARC, di tracciamento e di ricezione sono facoltativi.

- `dns_records[].type` (string): `MX`, `TXT` o `CNAME`.

- `dns_records[].name` (string): Nome host del record.

- `dns_records[].value` (string): Valore da pubblicare.

- `dns_records[].priority` (integer | null): Priorità MX, oppure `null` per gli altri tipi.

- `dns_records[].ttl` (string): Sempre `auto`.

- `dns_records[].status` (string): Esito dell’ultimo controllo DNS: `pending`, `ok`, `missing` o `invalid`.

- `dns_records[].error` (string | null): Perché l’ultimo controllo non è riuscito, oppure `null`.

---
Fonte: https://emailit.com/it/docs/webhooks/events/domain/domain-deleted/
