Eventi dei domini
Domini di invio creati, aggiornati o eliminati.
domain.created
Inviato quando viene aggiunto un dominio di invio al workspace, ad esempio con Crea un dominio. Il payload include i record DNS da pubblicare, che partono tutti come pending. Vedi Aggiungi un dominio.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID 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.
typestringSempre domain.created.
objectobjectIl dominio descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto dominio
idstringID del dominio (dom_…).
objectstringSempre domain.
namestringNome del dominio, ad esempio acme.com.
tracking_keystring | nullSottodominio personalizzato per il CNAME di tracciamento, oppure null per il valore predefinito go.
inbound_keystring | nullSottodominio personalizzato per il record MX di ricezione, oppure null per il valore predefinito inbound.
track_loadsbooleanIndica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.
track_clicksbooleanIndica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.
created_atstringQuando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.
dns_recordsobject[]Record DNS del dominio. Vedi Record DNS.
dns_records[].requiredbooleantrue 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[].typestringMX, TXT o CNAME.
dns_records[].namestringNome host del record.
dns_records[].valuestringValore da pubblicare.
dns_records[].priorityinteger | nullPriorità MX, oppure null per gli altri tipi.
dns_records[].ttlstringSempre auto.
dns_records[].statusstringEsito dell’ultimo controllo DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullPerché l’ultimo controllo non è riuscito, oppure null.
{
"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
Inviato quando cambiano le impostazioni di un dominio, ad esempio il tracciamento o le opzioni di ricezione, con Aggiorna un dominio o nel pannello. I controlli DNS e la verifica non generano questo evento; per seguire lo stato di verifica usa Recupera un dominio.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID 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.
typestringSempre domain.updated.
objectobjectIl dominio descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto dominio
idstringID del dominio (dom_…).
objectstringSempre domain.
namestringNome del dominio, ad esempio acme.com.
verified_atstring | nullQuando è stato verificato il dominio, oppure null se non è verificato.
tracking_keystring | nullSottodominio personalizzato per il CNAME di tracciamento, oppure null per il valore predefinito go.
inbound_keystring | nullSottodominio personalizzato per il record MX di ricezione, oppure null per il valore predefinito inbound.
track_loadsbooleanIndica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.
track_clicksbooleanIndica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.
dns_checked_atstring | nullQuando Emailit ha controllato l’ultima volta i record DNS.
created_atstringQuando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.
dns_recordsobject[]Record DNS del dominio. Vedi Record DNS.
dns_records[].requiredbooleantrue 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[].typestringMX, TXT o CNAME.
dns_records[].namestringNome host del record.
dns_records[].valuestringValore da pubblicare.
dns_records[].priorityinteger | nullPriorità MX, oppure null per gli altri tipi.
dns_records[].ttlstringSempre auto.
dns_records[].statusstringEsito dell’ultimo controllo DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullPerché l’ultimo controllo non è riuscito, oppure null.
{
"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
Inviato quando viene eliminato un dominio di invio, ad esempio con Elimina un dominio. Il payload è il dominio com’era prima di essere eliminato.
Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.
Campi
event_idstringID 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.
typestringSempre domain.deleted.
objectobjectIl dominio descritto dall’evento. I suoi campi sono elencati qui sotto.
data.objectobjectDi nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.
Oggetto dominio
idstringID del dominio (dom_…).
objectstringSempre domain.
namestringNome del dominio, ad esempio acme.com.
verified_atstring | nullQuando è stato verificato il dominio, oppure null se non è verificato.
tracking_keystring | nullSottodominio personalizzato per il CNAME di tracciamento, oppure null per il valore predefinito go.
inbound_keystring | nullSottodominio personalizzato per il record MX di ricezione, oppure null per il valore predefinito inbound.
track_loadsbooleanIndica se il tracciamento delle aperture è attivo per impostazione predefinita per le email inviate da questo dominio.
track_clicksbooleanIndica se il tracciamento dei clic è attivo per impostazione predefinita per le email inviate da questo dominio.
dns_checked_atstring | nullQuando Emailit ha controllato l’ultima volta i record DNS.
created_atstringQuando è stato aggiunto il dominio, in formato ISO 8601 con offset UTC.
dns_recordsobject[]Record DNS del dominio. Vedi Record DNS.
dns_records[].requiredbooleantrue 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[].typestringMX, TXT o CNAME.
dns_records[].namestringNome host del record.
dns_records[].valuestringValore da pubblicare.
dns_records[].priorityinteger | nullPriorità MX, oppure null per gli altri tipi.
dns_records[].ttlstringSempre auto.
dns_records[].statusstringEsito dell’ultimo controllo DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullPerché l’ultimo controllo non è riuscito, oppure null.
{
"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
}
]
}
}
}