Přejít na obsah
Dokumentace

Odesílejte e-maily, dohledávejte zprávy a jejich obsah a e-maily plánujte, rušte, odesílejte znovu nebo přeposílejte.

Základní URLhttps://api.emailit.com/v2AutentizaceChybyLimity rychlosti

Odeslání e-mailu

Odešle e-mail z ověřené odesílací domény. Každý příjemce dostane samostatnou kopii s vlastním ID e-mailu a každý příjemce stojí jeden kredit.

POST/emails

Funguje s API klíči s oprávněním sending i full. Odeslání se počítají do limitů odesílání workspace a úspěšná odpověď znamená, že e-mail byl přijat a zařazen do fronty, ne že už byl doručen. Doručení sledujte přes webhooky nebo Načtení e-mailu. Neověřené workspace mohou odesílat jen na e-mailové adresy účtů svých členů.

Hlavičky

Idempotency-Keystring

Jedinečný klíč, nejvýše 256 písmen, číslic, - a _. Opakovaný požadavek se stejným klíčem do 24 hodin vrátí první odpověď a znovu se neodešle. Viz Idempotence.

Parametry v těle požadavku

fromstringpovinné

Odesílatel ve tvaru hello@acme.com, nebo Acme <hello@acme.com>. Adresa musí být na ověřené odesílací doméně workspace, a pokud je klíč omezený na jednu doménu, tak na doméně klíče.

tostring | string[]povinné

Příjemci jako pole, nebo řetězec oddělený čárkami. Každá položka může být ada@example.com, nebo Ada Lovelace <ada@example.com>. Nejvýše 50.

ccstring | string[]
Příjemci kopie. Nejvýše 50.
bccstring | string[]
Příjemci skryté kopie. Nejvýše 50. V hlavičkách zprávy se nezobrazí.
reply_tostring | string[]
Adresy pro odpověď. Pokud odesíláte se šablonou a tento parametr vynecháte, použije se adresa pro odpověď ze šablony.
subjectstring
Předmět. Povinné, pokud ho neposkytne template.
htmlstring
Tělo v HTML. Potřebujete html, text, nebo obojí, pokud obsah neposkytne template.
textstring
Tělo v prostém textu. Když pošlete html i text, příjemci dostanou vícedílnou zprávu (multipart).
templatestring

Šablona k odeslání. Předejte ID šablony (tem_…), pokud chcete použít právě tuto verzi, nebo alias, pokud chcete použít jeho publikovanou verzi. subject, html a text v požadavku přepíšou hodnoty ze šablony. Viz Šablony.

variablesobject

Hodnoty pro proměnné jazyka Temple, například {{first_name}}, které se vykreslí v předmětu, HTML a textu. Funguje se šablonami i s obsahem přímo v požadavku.

attachmentsobject[]
Soubory k přiložení. Viz Objekt přílohy níže.
headersobject

Další hlavičky MIME jako dvojice název–hodnota, například {"List-Unsubscribe": "<https://acme.com/unsubscribe>"}. Message-ID nastavuje Emailit sám.

metaobject

Vaše vlastní data jako dvojice klíč–hodnota, například {"order_id": "1042"}. Hodnoty musí být řetězce. Uloží se s e-mailem a jsou součástí načtení e-mailu i obsahu webhooků.

scheduled_atstring

Kdy e-mail odeslat, jako datum a čas podle ISO 8601, například 2026-10-02T09:00:00Z, nebo anglicky, například tomorrow at 9am. U hodnot podle ISO 8601 uveďte časové pásmo. Čas v minulosti nebo hodnota, kterou nelze zpracovat (včetně unixového časového razítka), e-mail odešle hned. Naplánované e-maily mají až do odeslání stav scheduled.

trackingboolean | object

Zapne nebo vypne pro tento e-mail měření otevření a prokliků: true, false, nebo {"loads": true, "clicks": false}. Ve výchozím stavu se použije nastavení odesílací domény. Měření funguje, jen když je ověřený CNAME záznam pro měření domény; jinak je vypnuté a odpověď ukazuje false.

Objekt přílohy

filenamestringpovinné
Název souboru včetně povolené přípony (viz níže).
contentstring
Soubor v kódování Base64. Pošlete content, nebo url, ne obojí.
urlstring

Veřejná URL s http nebo https, ze které se soubor stáhne. Emailit ho stáhne při odeslání: stahování musí skončit do 30 sekund, soubor smí mít nejvýše 25 MB a nesmí docházet k přesměrování.

content_typestring
Typ MIME, například application/pdf. Povinné s content. S url je výchozí hodnotou typ, který vrátí server.
content_idstring

Udělá z přílohy vloženou přílohu. Pokud je content_id logo, odkažte na ni v HTML jako <img src="cid:logo">.

encodingstringvýchozí: base64
Kódování content, například base64 nebo hex.

Celá zpráva včetně příloh může mít nejvýše 40 MB. Povolené jsou tyto typy souborů:

Kategorie Přípony
Text .txt, .csv, .log, .css, .ics, .xml
Obrázky .jpg, .jpe, .jpeg, .gif, .png, .bmp, .psd, .tif, .tiff, .svg, .indd, .ai, .eps
Dokumenty .doc, .docx, .rtf, .odt, .ott, .pdf, .pub, .pages, .mobi, .epub
Zvuk .mp3, .m4a, .m4v, .wma, .ogg, .flac, .wav, .aif, .aifc, .aiff
Video .mp4, .mov, .avi, .mkv, .mpeg, .mpg, .wmv
Tabulky .xls, .xlsx, .ods, .numbers
Prezentace .odp, .ppt, .pptx, .pps, .key
Archivy .zip, .vcf
E-mail .eml
Kryptografie .p7c, .p7m, .p7s, .pgp, .asc, .sig

Odpověď

Vrací 200 s objektem e-mailu prvního příjemce. Když má zpráva v to, cc a bcc dohromady více než jednoho příjemce, ids přiřazuje každému příjemci ID jeho kopie. Každá kopie vyvolá událost email.accepted, nebo email.scheduled.

objectstring
Vždy email.
idstring
ID e-mailu prvního příjemce.
idsobject
Pro každého příjemce dvojice adresa příjemce – ID e-mailu. Uvádí se, jen pokud je příjemců víc.
tokenstring
Interní token prvního e-mailu.
message_idstring
Hlavička Message-ID prvního e-mailu, například <token@acme.com>.
fromstring
Odesílatel tak, jak jste ho poslali.
tostring[]
Adresy z to bez zobrazovaných jmen a duplicit.
ccstring[]
Příjemci z cc. Uvádí se, jen pokud jste nějaké poslali.
bccstring[]
Příjemci z bcc. Uvádí se, jen pokud jste nějaké poslali.
subjectstring
Předmět po vykreslení šablony a proměnných.
statusstring
accepted, nebo scheduled při scheduled_at v budoucnosti.
scheduled_atstring | null
Kdy se e-mail odešle, nebo null.
created_atstring
Kdy byl e-mail přijat.
trackingobject
Měření, které platí: logické hodnoty loads a clicks.
POST/emails
Terminal
curl -X POST https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": ["ada@example.com", "grace@example.com"],
    "subject": "Welcome to Acme",
    "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
    "tracking": {
      "loads": true,
      "clicks": true
    }
  }'
Terminal
curl -X POST https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "template": "welcome",
    "variables": {
      "first_name": "Ada",
      "activation_url": "https://acme.com/activate?token=8f2c1e"
    }
  }'
Terminal
curl -X POST https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme Billing <billing@acme.com>",
    "to": "ada@example.com",
    "subject": "Your invoice INV-1042",
    "html": "<img src=\"cid:logo\"><p>Your invoice is attached.</p>",
    "attachments": [
      {
        "filename": "INV-1042.pdf",
        "content": "JVBERi0xLjQKJcOkw7zDqc...",
        "content_type": "application/pdf"
      },
      {
        "filename": "logo.png",
        "url": "https://acme.com/assets/logo.png",
        "content_id": "logo"
      }
    ]
  }'
Terminal
curl -X POST https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reminder-appt-5531" \
  -d '{
    "from": "Acme <reminders@acme.com>",
    "to": "ada@example.com",
    "subject": "Your appointment tomorrow",
    "text": "See you tomorrow at 2 PM.",
    "scheduled_at": "2026-10-02T09:00:00Z",
    "meta": { "appointment_id": "5531" }
  }'
JSON
{
  "object": "email",
  "id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
  "ids": {
    "ada@example.com": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
    "grace@example.com": "em_4KfIXZSV8v8L1k0Mg2YDR3rytvj"
  },
  "token": "4KDY1iIpQSSW5pAoiz3JEfqcsO0",
  "message_id": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": ["ada@example.com", "grace@example.com"],
  "subject": "Welcome to Acme",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.482913Z",
  "tracking": {
    "loads": true,
    "clicks": true
  }
}

Výpis e-mailů

Vrátí stránku e-mailů od nejnovějších. Ve výchozím stavu výpis zobrazuje odchozí e-maily za posledních 14 dní.

GET/emails

Vyžaduje API klíč s oprávněním full. Každý příjemce jednoho odeslání je v tomto výpisu samostatný e-mail.

Parametry dotazu

pageintegervýchozí: 1
Stránka, kterou chcete načíst.
limitintegervýchozí: 25
Počet e-mailů na stránce, od 1 do 100.
typestringvýchozí: outbound
outbound pro e-maily, které jste odeslali, nebo inbound pro e-maily, které jste přijali.
date_fromstring

Jen e-maily vytvořené v toto datum nebo později, například 2026-08-01 (od 00:00 UTC). Bez tohoto parametru výpis začíná před 14 dny. Filtry created_at toto období nemění.

date_tostring
Jen e-maily vytvořené v toto datum nebo dříve, do 23:59:59 UTC.
matchstringvýchozí: all
all, nebo or. Jak se kombinují filtry níže.
orderstring
Klíč řazení z tabulky níže.
directionstring
asc, nebo desc.

Filtry

Filtry přidávejte ve tvaru key.condition=value, například status.exact=bounced nebo created_at.after=2026-09-01. Podmínky pro jednotlivé typy najdete na stránce Filtrování.

Klíč Typ Hodnoty a poznámky
to string Adresa příjemce.
from string Odesílatel tak, jak byl odeslán, včetně případného zobrazovaného jména.
subject string
status enum accepted, scheduled, delivered, loaded, clicked, attempted, bounced, failed, rejected, suppressed, received, complained, canceled, held
tag string Štítek e-mailu. Odesílání přes API nebo SMTP zatím štítek nenastavuje.
spam_score number
created_at date
updated_at date
api_key_id string ID API klíče, kterým byl e-mail odeslán (key_…).
sending_domain_id string ID odesílací domény (dom_…).

Podle každého klíče lze také řadit. Starší parametry dotazu status, rcpt_to, mail_from, subject, api_key_id a sending_domain_id stále fungují: status hledá přesnou shodu, parametry pro adresy a předmět částečnou.

Odpověď

Vrací pole data s objekty e-mailů a pole next_page_url a previous_page_url. Viz Stránkování. URL stránek neobsahují vaše filtry, takže další stránku si vyžádejte s vlastními parametry a page zvýšeným o jedna.

objectstring
Vždy email.
idstring
ID e-mailu.
typestring
outbound, nebo inbound.
fromstring
Odesílatel tak, jak byl odeslán.
tostring
Příjemce této kopie.
subjectstring
Předmět.
statusstring
Aktuální stav.
sizeinteger
Velikost zprávy v bajtech.
scheduled_atstring | null
Kdy se má naplánovaný e-mail odeslat, nebo null.
created_atstring
Kdy byl e-mail přijat k doručení, nebo přijat jako příchozí.
updated_atstring
Kdy se naposledy změnil stav.
metaobject | null
meta, které jste odeslali.
GET/emails
Terminal
curl -G https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d page=1 \
  -d limit=25
Terminal
curl -G https://api.emailit.com/v2/emails \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d status.exact=bounced \
  -d status.exact=failed \
  -d match=or \
  -d date_from=2026-09-01 \
  -d order=created_at \
  -d direction=desc
JSON
{
  "data": [
    {
      "object": "email",
      "id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
      "type": "outbound",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Welcome to Acme",
      "status": "delivered",
      "size": 4523,
      "scheduled_at": null,
      "created_at": "2026-10-01T09:30:12.482913Z",
      "updated_at": "2026-10-01T09:30:14.118204Z",
      "meta": null
    },
    {
      "object": "email",
      "id": "em_4KfIXZSV8v8L1k0Mg2YDR3rytvj",
      "type": "outbound",
      "from": "Acme <hello@acme.com>",
      "to": "grace@example.com",
      "subject": "Welcome to Acme",
      "status": "loaded",
      "size": 4527,
      "scheduled_at": null,
      "created_at": "2026-10-01T09:30:12.482913Z",
      "updated_at": "2026-10-01T09:41:03.770521Z",
      "meta": null
    }
  ],
  "next_page_url": "/app/v2/emails?page=2&limit=25",
  "previous_page_url": null
}

Načtení e-mailu

Načte e-mail s jeho stavem, zpracovanými hlavičkami, tělem v HTML a textu a přílohami.

GET/emails/{id}

Vyžaduje API klíč s oprávněním full. Obsah zpráv se uchovává po dobu uchovávání obsahu, kterou určuje váš tarif. Poté jsou headers, body a attachments prázdné a zůstane jen stav a metadata. Pokud chcete načíst jen část e-mailu, použijte Načtení těla e-mailu, Načtení metadat, Výpis příloh nebo Načtení surového MIME.

Parametry v cestě

idstringpovinné
ID e-mailu, například em_4KYof1ZzXndZE2VPi0DgULiekG8.

Odpověď

Vrací objekt e-mailu.

objectstring
Vždy email.
idstring
ID e-mailu.
typestring
outbound pro e-maily, které jste odeslali, inbound pro e-maily, které jste přijali.
tokenstring
Interní token e-mailu.
message_idstring
Hlavička Message-ID.
fromstring
Odesílatel tak, jak byl odeslán, například Acme <hello@acme.com>.
tostring
Příjemce této kopie.
subjectstring
Předmět.
statusstring

Aktuální stav: accepted, scheduled, delivered, loaded, clicked, attempted, bounced, failed, rejected, suppressed, received, complained, canceled nebo held. Viz Stavy e-mailů.

sizeinteger
Velikost zprávy v bajtech.
scheduled_atstring | null
Kdy se má naplánovaný e-mail odeslat, nebo null.
created_atstring
Kdy byl e-mail přijat k doručení, nebo přijat jako příchozí.
updated_atstring
Kdy se e-mail naposledy změnil.
trackingobject
Jen u odchozích. Zda je zapnuté měření otevření (loads) a prokliků (clicks).
metaobject | null
meta, které jste odeslali, nebo null.
headersobject | null
Hlavičky zprávy jako dvojice název–hodnota, nebo null po smazání obsahu.
bodyobject
text a html, každé jako řetězec, nebo null.
attachmentsobject[]

Přílohy, každá s filename, content_type, size v bajtech, content_id (u vložených souborů), content_disposition (attachment, nebo inline) a content (Base64).

GET/emails/{id}
Terminal
curl https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8 \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "email",
  "id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
  "type": "outbound",
  "token": "4KDY1iIpQSSW5pAoiz3JEfqcsO0",
  "message_id": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
  "from": "Acme Billing <billing@acme.com>",
  "to": "ada@example.com",
  "subject": "Your invoice INV-1042",
  "status": "delivered",
  "size": 48213,
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.482913Z",
  "updated_at": "2026-10-01T09:30:14.118204Z",
  "tracking": {
    "loads": true,
    "clicks": true
  },
  "meta": {
    "invoice_id": "INV-1042"
  },
  "headers": {
    "From": "Acme Billing <billing@acme.com>",
    "To": "ada@example.com",
    "Subject": "Your invoice INV-1042",
    "Message-ID": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
    "MIME-Version": "1.0",
    "Content-Type": "multipart/mixed; boundary=\"--_NmP-4f1c2a9e7b3d0e5f-Part_1\""
  },
  "body": {
    "text": "Your invoice is attached.",
    "html": "<p>Your invoice is attached.</p>"
  },
  "attachments": [
    {
      "filename": "INV-1042.pdf",
      "content_type": "application/pdf",
      "size": 40960,
      "content_id": null,
      "content_disposition": "attachment",
      "content": "JVBERi0xLjQKJcOkw7zDqc..."
    }
  ]
}

Načtení surového MIME

Načte úplný MIME zdroj e-mailu tak, jak ho Emailit uložil, spolu s jeho metadaty.

GET/emails/{id}/raw

Vyžaduje API klíč s oprávněním full. Použijte ho k archivaci zprávy, ladění její struktury nebo ke zpracování vlastní knihovnou pro MIME. Po uplynutí doby uchovávání obsahu jsou raw a headers null.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

Vrací metadata e-mailu jako Načtení metadat, ale bez attachments, a navíc surovou zprávu.

rawstring | null
Úplná zpráva MIME: hlavičky, prázdný řádek a tělo. Po smazání obsahu null.
headersobject | null
Hlavičky nejvyšší úrovně jako dvojice název–hodnota.

Ostatní pole (object, id, type, token, message_id, from, to, subject, status, size, scheduled_at, created_at, updated_at, tracking a meta) jsou stejná jako u Načtení e-mailu.

GET/emails/{id}/raw
Terminal
curl https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/raw \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "email",
  "id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
  "type": "outbound",
  "token": "4KDY1iIpQSSW5pAoiz3JEfqcsO0",
  "message_id": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": "ada@example.com",
  "subject": "Welcome to Acme",
  "status": "delivered",
  "size": 1342,
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.482913Z",
  "updated_at": "2026-10-01T09:30:14.118204Z",
  "tracking": {
    "loads": false,
    "clicks": false
  },
  "meta": null,
  "headers": {
    "From": "Acme <hello@acme.com>",
    "To": "ada@example.com",
    "Subject": "Welcome to Acme",
    "Message-ID": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
    "MIME-Version": "1.0",
    "Content-Type": "text/html; charset=utf-8"
  },
  "raw": "From: Acme <hello@acme.com>\r\nTo: ada@example.com\r\nSubject: Welcome to Acme\r\nMessage-ID: <4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>\r\nMIME-Version: 1.0\r\nContent-Type: text/html; charset=utf-8\r\nContent-Transfer-Encoding: quoted-printable\r\n\r\n<h1>Welcome!</h1><p>Thanks for signing up.</p>"
}

Výpis příloh

Vrátí přílohy e-mailu včetně jejich obsahu.

GET/emails/{id}/attachments

Vyžaduje API klíč s oprávněním full. Funguje pro odchozí i příchozí e-maily. Vložené obrázky (části s hlavičkou Content-ID) jsou zahrnuté. Pokud chcete seznam bez obsahu souborů, použijte Načtení metadat. Po uplynutí doby uchovávání obsahu je seznam prázdný.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

Vrací objekt seznamu se všemi přílohami. Seznam není stránkovaný.

objectstring
Vždy list.
dataobject[]
Přílohy.
data[].filenamestring
Název souboru.
data[].content_typestring
Typ MIME, například application/pdf.
data[].sizeinteger
Velikost dekódovaného souboru v bajtech.
data[].content_idstring | null
Content-ID vložené přílohy, nebo null.
data[].content_dispositionstring | null
attachment, nebo inline.
data[].contentstring
Soubor v kódování Base64.
GET/emails/{id}/attachments
Terminal
curl https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/attachments \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "list",
  "data": [
    {
      "filename": "INV-1042.pdf",
      "content_type": "application/pdf",
      "size": 40960,
      "content_id": null,
      "content_disposition": "attachment",
      "content": "JVBERi0xLjQKJcOkw7zDqc..."
    },
    {
      "filename": "logo.png",
      "content_type": "image/png",
      "size": 5120,
      "content_id": "logo",
      "content_disposition": "inline",
      "content": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ]
}

Načtení těla e-mailu

Vrátí tělo e-mailu v HTML a prostém textu, dekódované z jeho částí MIME.

GET/emails/{id}/body

Vyžaduje API klíč s oprávněním full. Funguje pro odchozí i příchozí e-maily. U odchozích e-mailů je tělo to, co se skutečně odeslalo, tedy po vykreslení šablony a proměnných. Po uplynutí doby uchovávání obsahu jsou obě pole null.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

textstring | null
Část v prostém textu, nebo null, pokud ji e-mail nemá.
htmlstring | null
Část v HTML, nebo null, pokud ji e-mail nemá.
GET/emails/{id}/body
Terminal
curl https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/body \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "text": "Welcome!\n\nThanks for signing up.",
  "html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>"
}

Načtení metadat

Načte e-mail bez těla: stav, hlavičky, vaše data meta a seznam příloh bez jejich obsahu.

GET/emails/{id}/meta

Vyžaduje API klíč s oprávněním full. Je to nejúspornější způsob, jak přečíst podrobnosti e-mailu, když nepotřebujete obsah.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

Vrací stejná pole jako Načtení e-mailu, bez body a s popisem attachments, ale bez jejich obsahu:

attachmentsobject[]
U každé přílohy filename, content_type, size, content_id a content_disposition. Bez content.
headersobject | null
Hlavičky zprávy jako dvojice název–hodnota, nebo null po smazání obsahu.
metaobject | null
meta, které jste s e-mailem odeslali.
GET/emails/{id}/meta
Terminal
curl https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/meta \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "email",
  "id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
  "type": "outbound",
  "token": "4KDY1iIpQSSW5pAoiz3JEfqcsO0",
  "message_id": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
  "from": "Acme Billing <billing@acme.com>",
  "to": "ada@example.com",
  "subject": "Your invoice INV-1042",
  "status": "delivered",
  "size": 48213,
  "scheduled_at": null,
  "created_at": "2026-10-01T09:30:12.482913Z",
  "updated_at": "2026-10-01T09:30:14.118204Z",
  "tracking": {
    "loads": true,
    "clicks": true
  },
  "meta": {
    "invoice_id": "INV-1042"
  },
  "headers": {
    "From": "Acme Billing <billing@acme.com>",
    "To": "ada@example.com",
    "Subject": "Your invoice INV-1042",
    "Message-ID": "<4KDY1iIpQSSW5pAoiz3JEfqcsO0@acme.com>",
    "MIME-Version": "1.0",
    "Content-Type": "multipart/mixed; boundary=\"--_NmP-4f1c2a9e7b3d0e5f-Part_1\""
  },
  "attachments": [
    {
      "filename": "INV-1042.pdf",
      "content_type": "application/pdf",
      "size": 40960,
      "content_id": null,
      "content_disposition": "attachment"
    }
  ]
}

Úprava naplánovaného e-mailu

Přesune naplánovaný e-mail na nový čas odeslání.

POST/emails/{id}

Funguje s API klíči s oprávněním sending i full. Přeplánovat můžete jen e-mail ve stavu scheduled, jehož aktuální čas odeslání je víc než 3 minuty daleko. Změnit lze jen čas odeslání; pokud chcete změnit obsah, e-mail zrušte a odešlete nový.

Naplánované odeslání více příjemcům vytvoří pro každého příjemce jeden e-mail. Přeplánujte každé ID z mapy ids v odpovědi na odeslání.

Parametry v cestě

idstringpovinné
ID naplánovaného e-mailu.

Parametry v těle požadavku

scheduled_atstringpovinné

Nový čas odeslání jako datum a čas podle ISO 8601, například 2026-10-03T09:00:00Z, nebo anglicky, například tomorrow at 3pm. Musí být víc než 3 minuty v budoucnosti.

Odpověď

objectstring
Vždy email.
idstring
ID e-mailu.
statusstring
Vždy scheduled.
scheduled_atstring
Nový čas odeslání.
updated_atstring
Kdy byl e-mail upraven.
messagestring
Potvrzující zpráva.

Pokud e-mail není naplánovaný, má se odeslat do 3 minut, nebo nový čas nelze zpracovat či je příliš brzy, vrací 422.

POST/emails/{id}
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4K76IA5sFNIsLXW9QC2ro8cDbOj \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at": "2026-10-03T09:00:00Z"}'
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4K76IA5sFNIsLXW9QC2ro8cDbOj \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at": "tomorrow at 3pm"}'
JSON
{
  "object": "email",
  "id": "em_4K76IA5sFNIsLXW9QC2ro8cDbOj",
  "status": "scheduled",
  "scheduled_at": "2026-10-03T09:00:00.000Z",
  "updated_at": "2026-10-01T10:15:40.207316Z",
  "message": "Email schedule has been updated successfully"
}

Zrušení e-mailu

Odebere e-mail z odesílací fronty a nastaví mu stav canceled.

POST/emails/{id}/cancel

Funguje s API klíči s oprávněním sending i full. Zrušení funguje bez záruky: e-mail vytáhne z fronty, ale pokud už pokus o doručení začal, může se tento pokus ještě dokončit a zastaví se jen zbývající opakování. Který případ nastal, vám odpověď sdělí v poli in_flight. Zrušení vyvolá událost email.canceled a kredit se nevrací. Akce Cancel delivery ve webovém rozhraní dělá totéž.

Stav Lze zrušit Poznámky
scheduled Ano Nejpozději 3 minuty před naplánovaným časem.
accepted Ano Zařazený do fronty a ještě nedoručený.
attempted Ano Zastaví zbývající opakování po dočasné chybě.
Jakýkoli jiný Ne E-mail už byl doručen, selhal, nebo byl zrušen.

Pokud chcete zrušit odeslání s více příjemci, zrušte každé ID z mapy ids v odpovědi na odeslání.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

objectstring
Vždy email.
idstring
ID e-mailu.
statusstring
Vždy canceled.
in_flightboolean
true, pokud už pokus o doručení může probíhat a ještě se může dokončit. false, pokud byl e-mail z fronty odebrán před jakýmkoli pokusem.
messagestring
Popis výsledku.
POST/emails/{id}/cancel
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4K76IA5sFNIsLXW9QC2ro8cDbOj/cancel \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "email",
  "id": "em_4K76IA5sFNIsLXW9QC2ro8cDbOj",
  "status": "canceled",
  "in_flight": false,
  "message": "Email has been canceled and removed from the send queue."
}

Opakované odeslání e-mailu

Zařadí do fronty kopii e-mailu, který neprošel. Kopie je nový e-mail s vlastním ID a původní e-mail si ponechá svůj stav.

POST/emails/{id}/retry

Funguje s API klíči s oprávněním sending i full. Kopie má stejného odesílatele, příjemce, předmět, obsah, hlavičky, meta a nastavení měření, ale novou hlavičku Message-ID. Stojí kredity jako nové odeslání: jeden kredit, u e-mailu z kampaně dva.

E-mail můžete odeslat znovu, pokud:

  • Je ve stavu bounced, failed, suppressed nebo held.
  • Byl vytvořen v posledních 30 dnech.
  • Jeho obsah ještě nebyl smazán po uplynutí vaší doby uchovávání a jeho odesílací doména stále existuje.

Nejdřív odstraňte příčinu. Zablokovaná adresa, která je stále na vašem seznamu blokovaných adres, se zablokuje znovu a zadržený e-mail se znovu zadrží, dokud se nevyřeší důvod zadržení.

Parametry v cestě

idstringpovinné
ID e-mailu, který chcete odeslat znovu.

Odpověď

objectstring
Vždy email.
idstring
ID nového e-mailu.
original_idstring
ID e-mailu, který jste odeslali znovu.
tokenstring
Interní token nového e-mailu.
message_idstring
Message-ID nového e-mailu.
fromstring
Odesílatel.
tostring
Příjemce.
subjectstring
Předmět.
statusstring
Vždy accepted.
created_atstring
Kdy byl nový e-mail vytvořen.
messagestring
Potvrzující zpráva.
POST/emails/{id}/retry
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4KKrQ7TzsVtzsS8zG069B2aMtoK/retry \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "object": "email",
  "id": "em_4KbeG9poqTmjvQZeN8pMoJkCVNd",
  "original_id": "em_4KKrQ7TzsVtzsS8zG069B2aMtoK",
  "token": "4KTnDU5PzzqDqp8UWb9qVhPVFOT",
  "message_id": "<4KTnDU5PzzqDqp8UWb9qVhPVFOT@acme.com>",
  "from": "Acme <hello@acme.com>",
  "to": "ada@example.com",
  "subject": "Welcome to Acme",
  "status": "accepted",
  "created_at": "2026-10-01T12:04:51.330482Z",
  "message": "Email has been queued for retry"
}

Přeposlání e-mailu

Odešle obsah odchozího e-mailu novým příjemcům jako nový e-mail. Původní e-mail se nemění.

POST/emails/{id}/forward

Funguje s API klíči s oprávněním sending i full. Ve výchozím stavu je přeposlání prostým opětovným odesláním původního HTML, textu a příloh. Pokud nastavíte include_headers, přidá se nad původní obsah blok „Forwarded message“ a volitelná poznámka.

Přeposlání je nové odeslání, takže platí pravidla z Odeslání e-mailu: adresa from musí být na ověřené odesílací doméně, každý příjemce stojí kredit a počítá se do limitů odesílání, měření se řídí nastavením domény a hlavička Idempotency-Key je podporovaná. Navíc může workspace přeposlat nejvýše 3 e-maily za hodinu.

Přeposlat lze jen odchozí e-maily, a to jen dokud je jejich obsah v rámci vaší doby uchovávání uložený. Pokud chcete přeposílat přijatou poštu, použijte automatizaci.

Parametry v cestě

idstringpovinné
ID odchozího e-mailu, který chcete přeposlat.

Hlavičky

Idempotency-Keystring
Umožní přeposlání bezpečně zopakovat. Viz Idempotence.

Parametry v těle požadavku

tostring | string[]povinné
Noví příjemci jako pole, nebo řetězec oddělený čárkami. Nejvýše 50.
include_headersbooleanvýchozí: false

Při true přidá blok „Forwarded message“ s původním odesílatelem, datem, předmětem a příjemcem a nad něj vaši poznámku. Při false odešle původní obsah znovu beze změny.

commentstring
Poznámka v prostém textu, která se vloží nad přeposlanou zprávu. Použije se jen s include_headers. Jako alias se přijímá i body.
htmlstring
Poznámka v HTML, která se v části HTML použije místo escapovaného comment. Použije se jen s include_headers.
textstring
Poznámka v prostém textu, která se v textové části použije místo comment. Použije se jen s include_headers.
fromstring
Odesílatel. Výchozí hodnota je from původního e-mailu.
subjectstring
Předmět. Výchozí hodnota je původní předmět, s include_headers pak Fwd: a původní předmět.

Původní přílohy se přiloží, pokud je jejich typ souboru povolený.

Odpověď

Vrací stejný objekt jako Odeslání e-mailu, se dvěma poli navíc:

original_idstring
ID e-mailu, který jste přeposlali.
messagestring
Potvrzující zpráva.

Po překročení limitu přeposílání vrátí API 429 s hlavičkou retry-after.

POST/emails/{id}/forward
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/forward \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "grace@example.com"
  }'
Terminal
curl -X POST https://api.emailit.com/v2/emails/em_4KYof1ZzXndZE2VPi0DgULiekG8/forward \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: fwd-inv-1042-grace" \
  -d '{
    "to": ["grace@example.com"],
    "include_headers": true,
    "comment": "Grace, here is the invoice Ada asked about."
  }'
JSON
{
  "object": "email",
  "id": "em_4K76IA5sFNIsLXW9QC2ro8cDbOj",
  "original_id": "em_4KYof1ZzXndZE2VPi0DgULiekG8",
  "token": "4KWzEED2cnej6UMjF4v508VqQIp",
  "message_id": "<4KWzEED2cnej6UMjF4v508VqQIp@acme.com>",
  "from": "Acme Billing <billing@acme.com>",
  "to": ["grace@example.com"],
  "subject": "Fwd: Your invoice INV-1042",
  "status": "accepted",
  "scheduled_at": null,
  "created_at": "2026-10-01T13:20:07.915203Z",
  "tracking": {
    "loads": true,
    "clicks": true
  },
  "message": "Email has been queued for forwarding"
}

Načtení jen stavu

Vrátí jen aktuální stav e-mailu.

GET/email/{id}

Vyžaduje API klíč s oprávněním full. Všimněte si jednotného čísla /email v cestě. Odpověď je malá, takže se tento endpoint hodí pro rychlé kontroly stavu. Pokud chcete změny stavu dostávat hned, když nastanou, použijte místo opakovaného dotazování webhooky.

Parametry v cestě

idstringpovinné
ID e-mailu.

Odpověď

statusstring

Aktuální stav: accepted, scheduled, delivered, loaded, clicked, attempted, bounced, failed, rejected, suppressed, received, complained, canceled nebo held. Viz Stavy e-mailů.

GET/email/{id}
Terminal
curl https://api.emailit.com/v2/email/em_4KYof1ZzXndZE2VPi0DgULiekG8 \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
JSON
{
  "status": "delivered"
}

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.