Události e-mailů

Životní cyklus každého odchozího i příchozího e-mailu, od přijetí po doručení, otevření, prokliky a odhlášení.

email.accepted
email.scheduled
email.delivered
email.attempted
email.bounced
email.failed
email.rejected
email.suppressed
email.held
email.canceled
email.complained
email.received
email.loaded
email.clicked
email.unsubscribed
email.resubscribed

email.accepted

Odesílá se, když endpoint Odeslání e-mailu nebo Přeposlání e-mailu přijme e-mail k okamžitému doručení. Emailit odešle jednu událost na každého příjemce, protože každý příjemce dostane vlastní ID e-mailu. E-maily odeslané přes SMTP a e-maily vytvořené přes endpoint Opakované odeslání e-mailu tuto událost nevyvolávají.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

ID 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.

typestring

Vždy email.accepted.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Odesílatel tak, jak byl uvedený v požadavku. Může obsahovat zobrazované jméno, například Acme <hello@acme.com>.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail s vlastním ID.

subjectstring

Předmět.

metaobject | null

Objekt meta, který jste s e-mailem odeslali, nebo null.

timestampstring

Kdy byl e-mail přijat, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.accepted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "meta": {
      "order_id": "1042"
    },
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "meta": {
        "order_id": "1042"
      },
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.scheduled

Odesílá se, když endpoint Odeslání e-mailu přijme e-mail s budoucím časem v poli scheduled_at. Emailit odešle jednu událost na každého příjemce. Když naplánovaný čas nastane, Emailit e-mail odešle bez události email.accepted; další událostí je událost doručení, například email.delivered.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.scheduled.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Odesílatel tak, jak byl uvedený v požadavku. Může obsahovat zobrazované jméno, například Acme <hello@acme.com>.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail s vlastním ID.

subjectstring

Předmět.

metaobject | null

Objekt meta, který jste s e-mailem odeslali, nebo null.

scheduled_atstring

Kdy Emailit e-mail odešle.

timestampstring

Kdy byl e-mail přijat, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.scheduled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.delivered

Odesílá se, když poštovní server příjemce e-mail přijme. Doručení znamená, že přijímající server za zprávu převzal odpovědnost; i tak ji ještě může přefiltrovat do spamu. Všechny stavy vysvětluje stránka Stavy e-mailů.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.delivered.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy delivered.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.delivered",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "delivered",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "delivered",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.attempted

Odesílá se pokaždé, když pokus o doručení selže s dočasnou chybou, například kvůli greylistingu nebo limitu rychlosti na přijímajícím serveru, a Emailit to zkusí znovu. Emailit to s rostoucími odstupy zkouší asi 21 hodin; pokud doručení stále selhává, e-mail skončí jako nedoručený a dostanete email.bounced.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.attempted.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy attempted.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

smtp_codeinteger | null

Kód odpovědi SMTP od přijímajícího serveru, například 421. Hodnota null, pokud pokus odložil sám Emailit, například když dočasně omezil doručování na tento server.

smtp_enhanced_codestring | null

Rozšířený stavový kód z odpovědi, například 4.7.0. Viz Rozšířené stavové kódy.

smtp_responsestring | null

Celá odpověď přijímajícího serveru.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.attempted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "attempted",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "smtp_code": 421,
    "smtp_enhanced_code": "4.7.0",
    "smtp_response": "421 4.7.0 Try again later, closing connection."
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "attempted",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "smtp_code": 421,
      "smtp_enhanced_code": "4.7.0",
      "smtp_response": "421 4.7.0 Try again later, closing connection."
    }
  }
}

email.bounced

Odesílá se, když e-mail nelze doručit: přijímající server ho odmítl s trvalou chybou, po doručení přišla zpráva o nedoručení, všechny pokusy o opakování selhaly nebo ho Emailit vůbec nemohl odeslat, například proto, že jeho odesílací doména byla smazána. Podle vašeho nastavení automatického blokování adres Emailit adresu také zablokuje. Viz Nedoručení a stížnosti.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.bounced.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy bounced.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.bounced",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "bounced",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "bounced",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.failed

Odesílá se, když Emailit nedokáže zpracovat zprávu o nedoručení, která přišla na adresu return path vašeho workspace, například kvůli interní chybě. Objekt popisuje zprávu o nedoručení, ne e-mail, který jste odeslali. Tato událost je vzácná: neúspěšná doručení vyvolávají email.bounced, nebo email.attempted.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.failed.

objectobject

Zpráva o nedoručení, které se událost týká. Její pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…) zprávy o nedoručení.

objectstring

Vždy email.

fromstring

Odesílatel zprávy o nedoručení, obvykle mailer daemon přijímajícího serveru.

tostring

Adresa return path vašeho workspace na subdoméně emailit. vaší odesílací domény.

subjectstring | null

Předmět zprávy o nedoručení.

statusstring

Vždy failed.

metaobject | null

U zpráv o nedoručení vždy null.

updated_atstring

Kdy byla zpráva o nedoručení naposledy upravena před touto událostí, ve formátu ISO 8601 s posunem vůči UTC.

created_atstring

Kdy Emailit zprávu o nedoručení přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.failed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "mailer-daemon@mx1.example.com",
    "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
    "subject": "Undelivered Mail Returned to Sender",
    "status": "failed",
    "meta": null,
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "mailer-daemon@mx1.example.com",
      "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
      "subject": "Undelivered Mail Returned to Sender",
      "status": "failed",
      "meta": null,
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.rejected

Odesílá se, když Emailit odmítne e-mail odeslat, protože váš workspace ještě nemá produkční přístup a příjemce není členem workspace. Dokud workspace není schválený, můžete odesílat jen na adresy účtů členů workspace.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.rejected.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy rejected.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.rejected",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "rejected",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "rejected",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.suppressed

Odesílá se, když Emailit e-mail neodešle, protože příjemce má na vašem seznamu blokovaných adres blokaci typu recipient. Pokud chcete na adresu znovu odesílat, odeberte ji přes endpoint Smazání blokace.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.suppressed.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy suppressed.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.suppressed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "suppressed",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "suppressed",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.held

Odesílá se, když Emailit e-mail místo odeslání zadrží. Stane se to, když je workspace zablokovaný, odesílací doména je pozastavená, API klíč je nastavený na zadržování zpráv, workspace nemá kredity nebo skóre kontroly spamu dosáhne prahové hodnoty (výchozí je 7) nebo ji překročí. Po odstranění příčiny e-mail odešlete znovu přes endpoint Opakované odeslání e-mailu.

Událost email.held v seznamu událostí ve webovém rozhraní není. Dostanete ji u webhooků se zapnutým all_events, nebo když ji přidáte do pole events přes endpoint Úprava webhooku.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.held.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy held.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.held",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "held",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "held",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.canceled

Odesílá se, když zrušíte e-mail přes endpoint Zrušení e-mailu. Pokud už probíhal pokus o doručení, může se ještě dokončit, takže může následovat událost doručení.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.canceled.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Odesílatel tak, jak je uložený u e-mailu. Může obsahovat zobrazované jméno.

tostring

Adresa příjemce.

subjectstring

Předmět.

statusstring

Vždy canceled.

previous_statusstring

Stav před zrušením: scheduled, accepted nebo attempted.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

timestampstring

Kdy byl e-mail zrušen, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.canceled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "status": "canceled",
    "previous_status": "scheduled",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "timestamp": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "status": "canceled",
      "previous_status": "scheduled",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "timestamp": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.complained

Odesílá se, když příjemce označí váš e-mail jako spam a jeho poskytovatel schránky to Emailitu nahlásí přes feedback loop. Podle vašeho nastavení automatického blokování adres Emailit pro adresu přidá blokaci typu complaint. Viz Nedoručení a stížnosti.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.complained.

objectobject

E-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele, bez zobrazovaného jména.

tostring

Adresa příjemce. Emailit vytváří pro každého příjemce samostatný e-mail.

subjectstring | null

Předmět.

statusstring

Vždy complained.

metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

updated_atstring

Kdy byl záznam e-mailu naposledy upraven před touto událostí, ve formátu ISO 8601 s posunem vůči UTC. Může být dřívější než samotná změna stavu.

created_atstring

Kdy Emailit e-mail přijal.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.complained",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "complained",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "complained",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.received

Odesílá se, když Emailit přijme e-mail na jednu z vašich příchozích adres. Obsah události zahrnuje jen obálku: tělo a přílohy načtěte podle id přes endpoint Načtení e-mailu.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.received.

objectobject

Přijatý e-mail, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring

ID přijatého e-mailu (em_…).

objectstring

Vždy email.

fromstring

Adresa odesílatele z hlavičky From.

tostring

Příchozí adresa, na kterou e-mail přišel.

subjectstring | null

Předmět.

created_atstring

Kdy Emailit e-mail přijal, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.received",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "ada@example.com",
    "to": "support@inbound.acme.com",
    "subject": "Question about my order",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "ada@example.com",
      "to": "support@inbound.acme.com",
      "subject": "Question about my order",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.loaded

Odesílá se pokaždé, když se načte měřicí pixel v e-mailu, což obvykle znamená, že ho příjemce otevřel. Měření otevření vyžaduje ověřenou doménu pro měření a zapnuté měření otevření u daného e-mailu. Kvůli e-mailovým klientům, kteří obrázky načítají předem nebo blokují, jsou otevření jen přibližná.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.loaded.

objectobject

Otevření, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt načtení

idstring

ID otevření (load_…).

objectstring

Vždy load.

email_idstring

ID e-mailu (em_…).

emailobject

E-mail.

email.idstring

ID e-mailu (em_…).

email.rcpt_tostring

Adresa příjemce.

email.mail_fromstring

Odesílatel tak, jak je uložený u e-mailu. Může obsahovat zobrazované jméno.

email.subjectstring | null

Předmět.

email.created_atstring

Kdy Emailit e-mail přijal.

email.campaignobject | null

id a name kampaně, která e-mail odeslala, nebo null u e-mailů odeslaných přes API nebo SMTP.

email.metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

contactobject | null

id a email kontaktu s adresou příjemce v tomto workspace, nebo null, pokud takový kontakt neexistuje.

ip_addressstring

IP adresa požadavku.

user_agentstring | null

User agent klienta, který požadavek odeslal.

created_atstring

Kdy se pixel načetl, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.loaded",
  "object": {
    "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
    "object": "load",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
      "object": "load",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.clicked

Odesílá se pokaždé, když někdo klikne na měřený odkaz v e-mailu. Měření prokliků vyžaduje ověřenou doménu pro měření a zapnuté měření prokliků u daného e-mailu. Emailit nefiltruje automatické prokliky, například kontroly odkazů bezpečnostními skenery.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.clicked.

objectobject

Proklik, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt prokliku

idstring

ID prokliku (click_…).

objectstring

Vždy click.

email_idstring

ID e-mailu (em_…).

emailobject

E-mail.

email.idstring

ID e-mailu (em_…).

email.rcpt_tostring

Adresa příjemce.

email.mail_fromstring

Odesílatel tak, jak je uložený u e-mailu. Může obsahovat zobrazované jméno.

email.subjectstring | null

Předmět.

email.created_atstring

Kdy Emailit e-mail přijal.

email.campaignobject | null

id a name kampaně, která e-mail odeslala, nebo null u e-mailů odeslaných přes API nebo SMTP.

email.metaobject | null

Objekt meta odeslaný s e-mailem, nebo null.

linkobject

Odkaz, na který příjemce klikl.

link.idstring

ID odkazu (link_…).

link.urlstring

Cílová URL.

contactobject | null

id a email kontaktu s adresou příjemce v tomto workspace, nebo null, pokud takový kontakt neexistuje.

ip_addressstring

IP adresa požadavku.

user_agentstring | null

User agent klienta, který požadavek odeslal.

created_atstring

Kdy k prokliku došlo, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.clicked",
  "object": {
    "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
    "object": "click",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "link": {
      "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
      "url": "https://acme.com/blog/october-update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
      "object": "click",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "link": {
        "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
        "url": "https://acme.com/blog/october-update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.unsubscribed

Odesílá se, když se kontakt odhlásí z vašich kampaní, například odkazem pro odhlášení v e-mailu z kampaně. Emailit odešle také subscriber.updated pro každý seznam kontaktů, ze kterého kontakt odešel. Viz Odhlášení.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.unsubscribed.

objectobject

E-mail z kampaně, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring | null

ID (em_…) e-mailu z kampaně, přes který kontakt akci provedl, nebo null, pokud ho Emailit nedokázal přiřadit.

objectstring

Vždy email.

fromstring

Odesílatel e-mailu z kampaně.

tostring

Adresa kontaktu.

subjectstring

Předmět e-mailu z kampaně.

campaignobject | null

id a name kampaně, nebo null.

contactobject | null

id a email kontaktu.

unsubscribed_atstring

Kdy se kontakt odhlásil, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.unsubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.resubscribed

Odesílá se, když se kontakt, který se odhlásil z vašich kampaní, znovu přihlásí, například volbou pro opětovné přihlášení na odhlašovací stránce. Emailit odešle také subscriber.updated pro každý seznam kontaktů, do kterého se kontakt vrátil.

Požadavky webhooků obsahují pole JSON s událostmi, jako je tato; viz Požadavky webhooků.

Pole

event_idstring

typestring

Vždy email.resubscribed.

objectobject

E-mail z kampaně, kterého se událost týká. Jeho pole jsou uvedena níže.

data.objectobject

Stejný objekt ještě jednou, v podobě, v jaké ho vrací API událostí v poli data.

Objekt e-mailu

idstring | null

ID (em_…) e-mailu z kampaně, přes který kontakt akci provedl, nebo null, pokud ho Emailit nedokázal přiřadit.

objectstring

Vždy email.

fromstring

Odesílatel e-mailu z kampaně.

tostring

Adresa kontaktu.

subjectstring

Předmět e-mailu z kampaně.

campaignobject | null

id a name kampaně, nebo null.

contactobject | null

id a email kontaktu.

resubscribed_atstring

Kdy se kontakt znovu přihlásil, ve formátu ISO 8601 s posunem vůči UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.resubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}