Přehled změn: REST API

MCP server na https://api.emailit.com/mcp teď pokrývá vše z API v2:

• Nové sady nástrojů: kampaně, automatizace, formuláře, DMARC reporty, ověřování e-mailů, události, hromadné akce a export kontaktů, odběratelé a testy, opakování a výměna tajného klíče u webhooků. Viz Reference nástrojů.
• Anotace: každý nástroj je označený jako read-only, destructive, idempotent nebo open-world, takže se klienti mohou před zápisovými akcemi zeptat.
• Strukturované výsledky: nástroje vracejí JSON jako text i jako strukturovaný obsah pro klienty, které ho zpracovávají.
• Vestavěné instrukce: server asistentům říká, aby před odesláním potvrdili příjemce a před jakýmkoli mazáním se zeptali.
• Sady nástrojů a režim jen pro čtení: načtěte méně nástrojů pomocí ?toolsets=, nebo skryjte zápisové nástroje pomocí ?read_only=true. Viz Sady nástrojů.
• Bezstavový transport: žádné relace MCP, které by mohly vypršet; klienti posílají každý požadavek metodou POST.

Opraveno: připojení přes OAuth schválená s oprávněními sending i full teď fungují u všech nástrojů a workspace, na který přepnete, zůstane vybraný i poté, co klient obnoví svůj token.

• API klíče vytvořené dřív, než klíče dostaly předponu secret_, se na /v2 opět přijímají.
• Načtení e-mailu vrací celý objekt e-mailu včetně object, from a to.
• Odpovědi pro domény vracejí track_loads a track_clicks jako 0, nebo 1, jak je zdokumentováno.

Otevřete Email API → Logs a uvidíte úspěšné i neúspěšné požadavky za poslední hodinu až posledních 30 dní. Filtrujte podle zdroje (API, nebo SMTP), výsledku, metody, cesty, stavového kódu, doby trvání nebo API klíče a otevřením požadavku zobrazíte těla požadavku a odpovědi. Citlivé hodnoty jsou skryté a dlouhá těla zkrácená.

Viz Logy požadavků.

Ve webovém rozhraní kombinujte podmínky v části Filters s volbou Match all, nebo Match any, kliknutím na záhlaví sloupců řaďte a sloupce vyberte v Display options.

V API filtrujte parametry dotazu field.condition=value, kombinujte je pomocí match=all, nebo match=or a řaďte parametry order a direction:

curl "https://api.emailit.com/v2/emails?status.exact=bounced&created_at.after=2026-09-01&order=created_at&direction=desc" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Každý endpoint pro výpis dokumentuje svá pole, podle kterých lze filtrovat. Viz Filtrování.

• Kontakty: vytvářejte, vypisujte, načítejte, upravujte a mažte kontakty. Kontakt dohledáte podle jeho ID con_ nebo e-mailové adresy a ve stejném volání ho můžete přidat do seznamů kontaktů.
• Události: vypisujte události filtrované podle jednoho nebo více typů, volitelně i s jejich daty, a načítejte jednotlivé události.
• Webhooky: vytvářejte, vypisujte, načítejte, upravujte a mažte endpointy webhooků.

Tyto endpointy potřebují klíč s plným přístupem. Viz Reference API.

ID jsou jedinečná napříč službami a řadí se podle času vytvoření. Běžné předpony jsou em_ pro e-maily, dom_ pro domény, key_ pro API klíče, aud_ pro seznamy kontaktů, sub_ pro odběratele, con_ pro kontakty, sup_ pro blokované adresy, wh_ pro webhooky, evt_ pro události a cmp_ pro kampaně.

ID ukládejte jako neprůhledné řetězce a nerozebírejte je.

Nové funkce vycházejí jen v API v2 na https://api.emailit.com/v2. Pokud ještě voláte /v1, přejděte na endpointy v2 a API klíč posílejte v hlavičce Authorization: Bearer.

Viz Verzování.

API klíče nahrazují přístupové údaje. Klíč má oprávnění full, nebo sending, 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.