Události domén
Vytvořené, upravené nebo smazané odesílací domény.
domain.created
Odesílá se, když se do workspace přidá odesílací doména, například přes endpoint Vytvoření domény. Obsah zahrnuje DNS záznamy, které máte zveřejnit; všechny začínají ve stavu pending. Viz Přidání odesílací domény.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy domain.created.
objectobjectDoména, které se událost týká. Její pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt domény
idstringID domény (dom_…).
objectstringVždy domain.
namestringNázev domény, například acme.com.
tracking_keystring | nullVlastní subdoména pro CNAME záznam pro měření, nebo null pro výchozí go.
inbound_keystring | nullVlastní subdoména pro MX záznam příchozí pošty, nebo null pro výchozí inbound.
track_loadsbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření otevření.
track_clicksbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření prokliků.
created_atstringKdy byla doména přidána, ve formátu ISO 8601 s posunem vůči UTC.
dns_recordsobject[]DNS záznamy domény. Viz DNS záznamy odesílacích domén.
dns_records[].requiredbooleantrue u MX záznamu pro return path a u záznamů SPF a DKIM, které jsou potřeba k ověření. Záznamy DMARC, pro měření a pro příchozí poštu jsou volitelné.
dns_records[].typestringMX, TXT nebo CNAME.
dns_records[].namestringNázev záznamu.
dns_records[].valuestringHodnota, kterou máte zveřejnit.
dns_records[].priorityinteger | nullPriorita MX, nebo null u ostatních typů.
dns_records[].ttlstringVždy auto.
dns_records[].statusstringVýsledek poslední kontroly DNS: pending, ok, missing nebo invalid.
dns_records[].errorstring | nullProč poslední kontrola selhala, nebo 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
Odesílá se, když se změní nastavení domény, například měření nebo možnosti příchozí pošty, přes endpoint Úprava domény nebo ve webovém rozhraní. Kontroly DNS a ověření tuto událost nevyvolávají; stav ověření sledujte přes endpoint Načtení domény.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy domain.updated.
objectobjectDoména, které se událost týká. Její pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt domény
idstringID domény (dom_…).
objectstringVždy domain.
namestringNázev domény, například acme.com.
verified_atstring | nullKdy byla doména ověřena, nebo null, pokud ověřená není.
tracking_keystring | nullVlastní subdoména pro CNAME záznam pro měření, nebo null pro výchozí go.
inbound_keystring | nullVlastní subdoména pro MX záznam příchozí pošty, nebo null pro výchozí inbound.
track_loadsbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření otevření.
track_clicksbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření prokliků.
dns_checked_atstring | nullKdy Emailit naposledy zkontroloval DNS záznamy.
created_atstringKdy byla doména přidána, ve formátu ISO 8601 s posunem vůči UTC.
dns_recordsobject[]DNS záznamy domény. Viz DNS záznamy odesílacích domén.
dns_records[].requiredbooleantrue u MX záznamu pro return path a u záznamů SPF a DKIM, které jsou potřeba k ověření. Záznamy DMARC, pro měření a pro příchozí poštu jsou volitelné.
dns_records[].typestringMX, TXT nebo CNAME.
dns_records[].namestringNázev záznamu.
dns_records[].valuestringHodnota, kterou máte zveřejnit.
dns_records[].priorityinteger | nullPriorita MX, nebo null u ostatních typů.
dns_records[].ttlstringVždy auto.
dns_records[].statusstringVýsledek poslední kontroly DNS: pending, ok, missing nebo invalid.
dns_records[].errorstring | nullProč poslední kontrola selhala, nebo 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
Odesílá se, když se smaže odesílací doména, například přes endpoint Smazání domény. Obsahem je doména ve stavu, v jakém byla před smazáním.
Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.
Pole
event_idstringID události (evt_…). Opakovaný požadavek nese stejné ID, takže podle něj můžete přeskočit události, které jste už zpracovali. Událost můžete také dohledat přes endpoint Načtení události.
typestringVždy domain.deleted.
objectobjectDoména, které se událost týká. Její pole jsou uvedena níže.
data.objectobjectStejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.
Objekt domény
idstringID domény (dom_…).
objectstringVždy domain.
namestringNázev domény, například acme.com.
verified_atstring | nullKdy byla doména ověřena, nebo null, pokud ověřená není.
tracking_keystring | nullVlastní subdoména pro CNAME záznam pro měření, nebo null pro výchozí go.
inbound_keystring | nullVlastní subdoména pro MX záznam příchozí pošty, nebo null pro výchozí inbound.
track_loadsbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření otevření.
track_clicksbooleanJestli je u e-mailů z této domény ve výchozím stavu zapnuté měření prokliků.
dns_checked_atstring | nullKdy Emailit naposledy zkontroloval DNS záznamy.
created_atstringKdy byla doména přidána, ve formátu ISO 8601 s posunem vůči UTC.
dns_recordsobject[]DNS záznamy domény. Viz DNS záznamy odesílacích domén.
dns_records[].requiredbooleantrue u MX záznamu pro return path a u záznamů SPF a DKIM, které jsou potřeba k ověření. Záznamy DMARC, pro měření a pro příchozí poštu jsou volitelné.
dns_records[].typestringMX, TXT nebo CNAME.
dns_records[].namestringNázev záznamu.
dns_records[].valuestringHodnota, kterou máte zveřejnit.
dns_records[].priorityinteger | nullPriorita MX, nebo null u ostatních typů.
dns_records[].ttlstringVždy auto.
dns_records[].statusstringVýsledek poslední kontroly DNS: pending, ok, missing nebo invalid.
dns_records[].errorstring | nullProč poslední kontrola selhala, nebo 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
}
]
}
}
}