Eventos de dominios
Dominios de envío creados, actualizados o eliminados.
domain.created
Se envía cuando se añade un dominio de envío al espacio de trabajo, por ejemplo con Crear un dominio. El payload incluye los registros DNS que hay que publicar; todos empiezan como pending. Consulta Añadir un dominio.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre domain.created.
objectobjectEl dominio que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de dominio
idstringEl ID del dominio (dom_…).
objectstringSiempre domain.
namestringEl nombre del dominio, por ejemplo acme.com.
tracking_keystring | nullEl subdominio personalizado del registro CNAME de seguimiento, o null para el valor por defecto, go.
inbound_keystring | nullEl subdominio personalizado del registro MX de entrada, o null para el valor por defecto, inbound.
track_loadsbooleanSi el seguimiento de aperturas está activado por defecto en los emails de este dominio.
track_clicksbooleanSi el seguimiento de clics está activado por defecto en los emails de este dominio.
created_atstringCuándo se añadió el dominio, en formato ISO 8601 con desfase respecto a UTC.
dns_recordsobject[]Los registros DNS del dominio. Consulta Registros DNS.
dns_records[].requiredbooleantrue en los registros MX del return-path, SPF y DKIM, que son necesarios para la verificación. Los registros DMARC, de seguimiento y de entrada son opcionales.
dns_records[].typestringMX, TXT o CNAME.
dns_records[].namestringEl nombre de host del registro.
dns_records[].valuestringEl valor que hay que publicar.
dns_records[].priorityinteger | nullLa prioridad MX, o null en los demás tipos.
dns_records[].ttlstringSiempre auto.
dns_records[].statusstringEl resultado de la última comprobación de DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullEl motivo por el que falló la última comprobación, o 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
Se envía cuando cambia la configuración de un dominio, por ejemplo sus opciones de seguimiento o de entrada, con Actualizar un dominio o en el panel. Las comprobaciones de DNS y la verificación no envían este evento; usa Obtener un dominio para seguir el estado de la verificación.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre domain.updated.
objectobjectEl dominio que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de dominio
idstringEl ID del dominio (dom_…).
objectstringSiempre domain.
namestringEl nombre del dominio, por ejemplo acme.com.
verified_atstring | nullCuándo se verificó el dominio, o null si no está verificado.
tracking_keystring | nullEl subdominio personalizado del registro CNAME de seguimiento, o null para el valor por defecto, go.
inbound_keystring | nullEl subdominio personalizado del registro MX de entrada, o null para el valor por defecto, inbound.
track_loadsbooleanSi el seguimiento de aperturas está activado por defecto en los emails de este dominio.
track_clicksbooleanSi el seguimiento de clics está activado por defecto en los emails de este dominio.
dns_checked_atstring | nullCuándo comprobó Emailit los registros DNS por última vez.
created_atstringCuándo se añadió el dominio, en formato ISO 8601 con desfase respecto a UTC.
dns_recordsobject[]Los registros DNS del dominio. Consulta Registros DNS.
dns_records[].requiredbooleantrue en los registros MX del return-path, SPF y DKIM, que son necesarios para la verificación. Los registros DMARC, de seguimiento y de entrada son opcionales.
dns_records[].typestringMX, TXT o CNAME.
dns_records[].namestringEl nombre de host del registro.
dns_records[].valuestringEl valor que hay que publicar.
dns_records[].priorityinteger | nullLa prioridad MX, o null en los demás tipos.
dns_records[].ttlstringSiempre auto.
dns_records[].statusstringEl resultado de la última comprobación de DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullEl motivo por el que falló la última comprobación, o 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
Se envía cuando se elimina un dominio de envío, por ejemplo con Eliminar un dominio. El payload es el dominio tal como estaba antes de eliminarse.
Las peticiones de webhook contienen un array JSON de eventos como este; consulta Peticiones de webhook.
Campos
event_idstringEl ID del evento (evt_…). Una petición reintentada lleva el mismo ID, así que úsalo para omitir los eventos que ya hayas procesado. También puedes consultar el evento con Obtener un evento.
typestringSiempre domain.deleted.
objectobjectEl dominio que describe el evento. Sus campos se indican a continuación.
data.objectobjectEl mismo objeto otra vez, con la forma que devuelve la API de eventos en data.
Objeto de dominio
idstringEl ID del dominio (dom_…).
objectstringSiempre domain.
namestringEl nombre del dominio, por ejemplo acme.com.
verified_atstring | nullCuándo se verificó el dominio, o null si no está verificado.
tracking_keystring | nullEl subdominio personalizado del registro CNAME de seguimiento, o null para el valor por defecto, go.
inbound_keystring | nullEl subdominio personalizado del registro MX de entrada, o null para el valor por defecto, inbound.
track_loadsbooleanSi el seguimiento de aperturas está activado por defecto en los emails de este dominio.
track_clicksbooleanSi el seguimiento de clics está activado por defecto en los emails de este dominio.
dns_checked_atstring | nullCuándo comprobó Emailit los registros DNS por última vez.
created_atstringCuándo se añadió el dominio, en formato ISO 8601 con desfase respecto a UTC.
dns_recordsobject[]Los registros DNS del dominio. Consulta Registros DNS.
dns_records[].requiredbooleantrue en los registros MX del return-path, SPF y DKIM, que son necesarios para la verificación. Los registros DMARC, de seguimiento y de entrada son opcionales.
dns_records[].typestringMX, TXT o CNAME.
dns_records[].namestringEl nombre de host del registro.
dns_records[].valuestringEl valor que hay que publicar.
dns_records[].priorityinteger | nullLa prioridad MX, o null en los demás tipos.
dns_records[].ttlstringSiempre auto.
dns_records[].statusstringEl resultado de la última comprobación de DNS: pending, ok, missing o invalid.
dns_records[].errorstring | nullEl motivo por el que falló la última comprobación, o 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
}
]
}
}
}