Reference
Přehled změn: API klíče
Změny v produktu API klíče: nové funkce, vylepšení a opravy.
říjen 2026
Nové
Sledování událostí: události workspace a vlastní události
Sledování událostíAPI klíčeWebhooky
Vedle událostí, které zaznamenává Emailit, teď můžete odesílat i události ze svých systémů, například objednávku, změnu tarifu nebo zobrazení produktu. Spravujete je na nových kartách Workspace events a Tracking v sekci Email API > Events.
- Dva rozsahy. Události workspace (
w:<name>) se nejdřív deklarují s typovanými vlastnostmi a Emailit odmítne události, které jim neodpovídají. Vlastní události (c:<name>) přijmou libovolný objekt JSON. Log událostí má filtr Scope a endpoint Výpis událostí parametrscope. - Ze serverů. Odeslání události zaznamená jednu událost a Dávkové odeslání událostí až 100. Fungují s novými API klíči s oprávněním Events Only, které mohou odesílat události, ale nemohou číst data ani odesílat e-maily.
- Z webu. Sledovací skript odesílá události s veřejným sledovacím klíčem, který můžete omezit na své weby.
identifypropojí události návštěvníka s kontaktem. - Kontakty a webhooky. Události se zobrazují v panelu Activity log kontaktu. Webhooky dostávají typy, které vyberete, nebo pomocí
w:*ac:*všechny události workspace či všechny vlastní události. - API a MCP. API událostí workspace a API sledovacích klíčů a v sadě nástrojů MCP
eventsnástrojsend-eventa nástroje pro události workspace. - Tarify. Sledování událostí a sledovací skript jsou součástí tarifů Pro, Business a Custom. Tarif Pro může používat 100 typů událostí, tarif Business 1 000 a tarif Custom nemá žádný limit. Viz Limity.
Viz Sledování událostí.
- Dva rozsahy. Události workspace (
září 2026
Opravené
Opravy kompatibility API v2
REST APIAPI klíčeE-mailové APIOdesílací domény
- API klíče vytvořené dřív, než klíče dostaly předponu
secret_, se na/v2opět přijímají. - Načtení e-mailu vrací celý objekt e-mailu včetně
object,fromato. - Odpovědi pro domény vracejí
track_loadsatrack_clicksjako0, nebo1, jak je zdokumentováno.
- API klíče vytvořené dřív, než klíče dostaly předponu
Změněné
API klíče jen pro odesílání omezené na endpointy pro odesílání
Klíče jen pro odesílání dřív mohly vypisovat a načítat e-maily a volat některé další endpointy pro čtení. Teď jsou omezené na Odeslání e-mailu a akce s existujícím e-mailem: přeplánování, zrušení, opakované odeslání a přeposlání. Ostatní endpointy klíče pro odesílání odmítnou.
Pokud vaše integrace čte také e-maily, domény nebo jiné zdroje, použijte pro tato volání klíč s plným přístupem. Viz API klíče.
říjen 2025
Nové
API v2
REST APIAPI klíčeOdesílací doménySeznamy kontaktůBlokované adresy
API klíče nahrazují přístupové údaje. Klíč má oprávnění
full, nebosending, klíč pro odesílání lze omezit na jednu odesílací doménu a klíče můžete spravovat přes API. API v1 zůstalo během přechodu dostupné.Viz Reference API.