# Poštárna > Poštárna je česká platforma na e-mailový marketing: hromadné rozosielky, automatizácie a štatistiky, ktoré ukážu, čo každý e-mail zarobil. Pre firmy aj e-shopy v Česku a na Slovensku, aplikácia aj podpora po slovensky a po česky. Prevádzkovateľ deriverge s.r.o., IČO 19456361. - Magic Editor: Bloky pretiahnete myšou, na telefóne ich vložíte ťuknutím. Editor ukladá sám. - Automatizácie: Scenár poskladáte na plátne a pred spustením ho vyskúšate nanečisto. Nič sa pritom neodošle. - Uvidíte, čo každý e-mail zarobil. Doručenia, otvorenia, kliky aj objednávky pri každej kampani a každom e-maile automatizácie. - Pre e-shopy: Produkty z feedu, Opustený košík, Objednávky v štatistikách, Kúpte si znova, SK a CZ v jednej kampani. - Prechod zo SmartEmailingu: Stačí API kľúč. Poštárna zo SmartEmailingu iba číta a nič v ňom nemení. - Cenník: Platíte podľa počtu kontaktov. Bez záväzkov, mesačne alebo ročne. Ceny sú bez DPH. Automatizácie, feedy, kupóny, formuláre, landing pages, štatistiky aj podpora v každom tarife. Aktuálny cenník (JSON): https://www.postarna.sk/api/v1/public/price-list - API: API v1 (`/api/v1/tenants/{tenant}/...`) je úplné API, ktoré používa aj webová aplikácia; API v3 (`/api/v3/...`) je kompatibilné so SmartEmailingom; server MCP (`/mcp`) slúži AI asistentom. Prihlásenie API kľúčom: `Authorization: Bearer pst_...`. - Celý strojovo čitateľný popis API: https://www.postarna.cz/api/openapi.json (OpenAPI 3.1). Len jedna skupina: `?tag=Automations` (názvy skupín v poli `tags`). - Pred odoslaním skutočným príjemcom (schválenie kampane, zapnutie automatizácie) vždy najprv spočítajte príjemcov a overte nastavenie: kampaň `POST /campaigns/audience`, automatizácia `POST /automations/validate` a `POST /automations/{id}/test`. ## Produkt - [Poštárna](https://www.postarna.sk/): Hromadné rozosielky, automatizácie a podrobné štatistiky pre firmy všetkých veľkostí. Magic Editor, segmenty, unikátne zľavové kódy, meniny a narodeniny, napojenie na e-shop aj prechod zo SmartEmailingu. Po slovensky a po česky. - [Funkcie](https://www.postarna.sk/#features): Napíšte e-mail, ktorý vyzerá skvele. Pošlite ho presne tým, koho sa týka. A uvidíte, čo vám zarobil. - [Automatizácie](https://www.postarna.sk/#automation): Scenár poskladáte na plátne a pred spustením ho vyskúšate nanečisto. Nič sa pritom neodošle. - [Prechod zo SmartEmailingu](https://www.postarna.sk/#switch): Stačí API kľúč. Poštárna zo SmartEmailingu iba číta a nič v ňom nemení. - [Cenník](https://www.postarna.sk/#pricing): Platíte podľa počtu kontaktov. Bez záväzkov, mesačne alebo ročne. Ceny sú bez DPH. - [Aktuálny cenník (JSON)](https://www.postarna.sk/api/v1/public/price-list): tarify podľa počtu kontaktov s mesačnou cenou bez DPH, ročná zľava, skúšobná doba a limity bezplatného tarifu, priamo z cenníka aplikácie - [Časté otázky](https://www.postarna.sk/#faq): odpovede na otázky: Kto Poštárnu prevádzkuje? Hodí sa Poštárna pre moju firmu? Z akej adresy sa e-maily odosielajú? Ako prejdem zo SmartEmailingu? Ako Poštárna nakladá s osobnými údajmi? Kde nájdem pomoc? ## Návody a zdroje - [Cenník Poštárne](https://www.postarna.sk/cennik): Aktuálny cenník Poštárne: tarify podľa počtu kontaktov, mesačná cena bez DPH, ročná zľava a skúšobná doba. Všetky funkcie v každom tarife. - [Návody na e-mailový marketing](https://www.postarna.sk/navody): Praktické návody krok za krokom: prvý newsletter, opustený košík, e-maily k meninám, win-back, formulár s double opt-in, prechod zo SmartEmailingu, SPF, DKIM a DMARC a segmentácia zákazníkov. - [Ako poslať prvý newsletter](https://www.postarna.sk/navody/prvy-newsletter): Od overenia domény cez import kontaktov a šablónu v editore po testovací e-mail a odoslanie kampane. Prvý newsletter v Poštárni krok za krokom. - [Opustený košík krok za krokom](https://www.postarna.sk/navody/opusteny-kosik): Ako napojiť e-shop postavený na Shoptete jedným riadkom v pätičke a poslať zákazníkovi pripomenutie košíka dve hodiny po poslednej zmene, len keď neobjednal. - [E-maily k meninám a narodeninám](https://www.postarna.sk/navody/meniny-a-narodeniny): Automatické blahoželanie k meninám alebo narodeninám s osobným oslovením a jednorazovým zľavovým kódom. Slovenský aj český kalendár mien. - [Win-back kampaň pre neaktívnych zákazníkov](https://www.postarna.sk/navody/win-back): Ako automaticky osloviť zákazníkov, ktorí dlho nenakúpili: pripomenutie, druhý e-mail s výhodou a koniec série pre tých, ktorí medzitým nakúpia. - [Formulár s potvrdením odberu (double opt-in)](https://www.postarna.sk/navody/formular-double-opt-in): Prihlasovací formulár na web alebo ako pop-up, s potvrdením odberu e-mailom a doloženým súhlasom podľa GDPR. Postup v Poštárni. - [Prechod zo SmartEmailingu do Poštárne](https://www.postarna.sk/navody/prechod-zo-smartemailingu): Ako sami preniesť kontakty, zoznamy, odhlásenia, súhlasy, šablóny a automatizácie zo SmartEmailingu do Poštárne. Stačí API kľúč, v SmartEmailingu sa nič nezmení. - [Lepšia doručiteľnosť so SPF, DKIM a DMARC](https://www.postarna.sk/navody/spf-dkim-dmarc): Prečo e-maily padajú do spamu a ako to opraviť: overenie domény cez DKIM, záznam SPF a DMARC, postupné zvyšovanie objemu a čistá databáza. Návod pre Poštárnu. - [Segmentácia zákazníkov v e-mailingu](https://www.postarna.sk/navody/segmentacia-zakaznikov): Ako rozdeliť kontakty podľa nákupov, aktivity a súhlasov a posielať každej skupine to, čo ju zaujíma. Príklady segmentov pre e-shopy a postup v Poštárni. - [Slovník pojmov e-mailového marketingu](https://www.postarna.sk/slovnik): Čo znamená double opt-in, miera otvorenia, CTR, soft a hard bounce, SPF, DKIM, DMARC, segment, opustený košík alebo win-back. Krátke definície a ako to rieši Poštárna. - [Integrácie Poštárne](https://www.postarna.sk/integracie): Napojenie Poštárne na Shoptet, produktové feedy Google Merchant, Heureka a Zboží.cz, RSS, import CSV, webhooky, API, API kompatibilné so SmartEmailingom a MCP pre AI asistentov. ## API dokumentácia: Začíname - [API dokumentácia Poštárne](https://www.postarna.sk/docs/api): Čo API Poštárne vie, ako je dokumentácia usporiadaná a kde začať. - [Začíname](https://www.postarna.sk/docs/api/getting-started): API kľúč, ID firmy a prvé volanie API za päť minút. - [Pravidlá API](https://www.postarna.sk/docs/api/conventions): Formáty dát, stránkovanie, triedenie, chyby, limity požiadaviek, opakovanie a súbežné úpravy. ## API dokumentácia: Koncepty - [Firma a e-shopy](https://www.postarna.sk/docs/api/tenants-and-shops): Firma (tenant), jej e-shopy s menou a jazykom, časová zóna a izolácia dát. - [Kontakty a súhlasy](https://www.postarna.sk/docs/api/contacts-and-consent): Kontakt a jeho stavy, súhlasy a účely spracúvania, potlačenie a blacklist, komu Poštárna smie písať. - [Zoznamy a segmenty](https://www.postarna.sk/docs/api/lists-and-segments): Kedy použiť zoznam a kedy segment, stavy členstva, jazyk podmienok segmentov a živý náhľad počtu. - [Šablóny a personalizácia](https://www.postarna.sk/docs/api/templates-and-personalization): Šablóny e-mailov, obsah a verzie, kontrola obsahu, zástupné značky, skripty Twig, kupóny a dáta objednávok. - [Kampane](https://www.postarna.sk/docs/api/campaigns): Životný cyklus kampane, publikum a jeho výpočet, schválenie s počtom príjemcov, plánovanie, pauza a zrušenie. - [Automatizácie](https://www.postarna.sk/docs/api/automations): Model grafu, uzly a výstupy, spúšťače, jazyk podmienok, čakanie, validácia, zapnutie, uloženie bežiaceho scenára, verzie a testovanie. - [Referencia automatizácií](https://www.postarna.sk/docs/api/automation-reference): Presné schémy všetkých uzlov automatizácie, udalostí, podmienok, pravidiel segmentov a časových údajov s overenými príkladmi. - [Objednávky, feedy a kupóny](https://www.postarna.sk/docs/api/orders-feeds-coupons): Zápis objednávok a mapa stavov, produktové, zákaznické a objednávkové feedy, zásobníky zľavových kupónov a konverzie. ## API dokumentácia: Recepty - [Recept: opustený košík](https://www.postarna.sk/docs/api/recipe-abandoned-cart): Automatizácia, ktorá za 2 hodiny pripomenie neodoslaný košík, s udalosťami košíka posielanými z e-shopu. - [Recept: séria po nákupe](https://www.postarna.sk/docs/api/recipe-post-purchase): Poďakovanie a prosba o hodnotenie 3 dni po dokončenej objednávke, tip na prípravu tým, kto nekliknú. - [Recept: meniny so zľavou](https://www.postarna.sk/docs/api/recipe-name-days): Každý deň o 8:00 zablahoželať kontaktom, ktoré majú meniny, a dať im jednorazový zľavový kód. - [Recept: návrat neaktívnych zákazníkov](https://www.postarna.sk/docs/api/recipe-win-back): Zákazníkom 120 dní bez nákupu poslať pripomenutie a po týždni druhé, ak medzitým nenakúpia. - [Recept: prihlasovací formulár s potvrdením](https://www.postarna.sk/docs/api/recipe-double-opt-in): Formulár s double opt-in na web, zoznam odberateľov, súhlas s účelom a uvítací e-mail po potvrdení. - [Recept: import kontaktov z CSV](https://www.postarna.sk/docs/api/recipe-import-contacts): Nahranie CSV, náhľad mapovania a problémov, spustenie importu s doloženým súhlasom a sledovanie priebehu. - [Recept: odoslanie kampane](https://www.postarna.sk/docs/api/recipe-send-campaign): Koncept kampane, obsah, kontrola obsahu, počet príjemcov, testovací e-mail, schválenie s plánovaným časom a zrušenie. - [Recept: príjem webhookov](https://www.postarna.sk/docs/api/recipe-webhook-consumer): Registrácia účtových webhookov, overenie Basic, idempotentné spracovanie a ukázkový príjemca v Pythone a Node.js. ## API dokumentácia: Integrácie - [Webhooky](https://www.postarna.sk/docs/api/webhooks): Účtové webhooky (nový kontakt, odhlásenie, doručenie, otvorenie, klik), tvar dát, doručovanie a opakovanie, zabezpečenie a webhook v automatizácii. - [MCP pre AI asistentov](https://www.postarna.sk/docs/api/mcp): Pripojenie ChatGPT, Claude a ďalších klientov k serveru MCP Poštárne, rozsahy prístupu, nástroje a povinné potvrdenie pred odoslaním. - [Kompatibilita so SmartEmailingom](https://www.postarna.sk/docs/api/smartemailing): API v3 a CSV štatistiky s rovnakými cestami, obálkami a chybami ako SmartEmailing, prihlásenie, limity a rozdiely. ## API dokumentácia: Referencia API - [Prehľad operácií](https://www.postarna.sk/docs/api/reference): Všetky operácie API po skupinách s odkazmi na podrobnú referenciu a strojovo čitateľný dokument OpenAPI. - [Chyby a limity](https://www.postarna.sk/docs/api/errors-and-limits): Každý kód chyby s významom a nápravou, HTTP stavy, limity požiadaviek a limity jednotlivých akcií. - [Contacts](https://www.postarna.sk/docs/api/reference-contacts): Contacts of the company: profile fields, consent state, suppressions, custom fields, purposes of processing (consents), activities and GDPR export and erasure. - [Lists](https://www.postarna.sk/docs/api/reference-lists): Contact lists with explicit membership (manual and form lists) and the lists bound to an e-shop (read only membership). - [Segments](https://www.postarna.sk/docs/api/reference-segments): Rule based groups of contacts of one e-shop: an AND / OR tree of conditions, evaluated live (daily) or as a snapshot (static). - [Campaigns](https://www.postarna.sk/docs/api/reference-campaigns): One-off e-mail campaigns (newsletters): draft, audience, content, test, approve (send now or schedule), pause, resume, cancel, language variants. - [Templates and content](https://www.postarna.sk/docs/api/reference-templates): E-mail templates (HTML or the visual MJML editor), content versions, lint and spam check, footers, unsubscribe pages, saved editor elements, script templates (Twig), SMS templates, landing pages, surveys and the file manager. - [Automations](https://www.postarna.sk/docs/api/reference-automations): Automation scenarios: a graph of triggers, conditions, waits and actions; validation, versions, activation, test and trace, run history, statistics, and the contact events API that feeds event triggers (custom events, carts, page visits). - [Forms](https://www.postarna.sk/docs/api/reference-forms): Sign-up forms (double opt-in): builder settings, embed code, history. - [Imports and exports](https://www.postarna.sk/docs/api/reference-imports-and-exports): CSV import of contacts (upload, preview, run) and CSV exports. - [Orders, feeds and coupons](https://www.postarna.sk/docs/api/reference-orders-and-feeds): Orders of the e-shops (they drive purchase triggers and conditions), order states, product and customer feeds, coupon stacks. - [Statistics](https://www.postarna.sk/docs/api/reference-statistics): E-mail statistics of campaigns and automations, dashboard, conversions. - [Sending and deliverability](https://www.postarna.sk/docs/api/reference-sending): Senders, sending domains (SPF, DKIM, DMARC), DMARC reports, sending mode. - [Account and settings](https://www.postarna.sk/docs/api/reference-account): Shops (e-shops) of the company, company data, consent settings, notifications, labels, web tracking, billing (read), SmartEmailing migration state. - [SmartEmailing compatible API v3](https://www.postarna.sk/docs/api/reference-smartemailing-v3): The same paths, envelopes and errors as SmartEmailing REST API v3 (read operations and account webhooks). HTTP Basic: member e-mail + API key. - [SmartEmailing compatible CSV statistics](https://www.postarna.sk/docs/api/reference-smartemailing-csv): Semicolon separated CSV as SmartEmailing /api/csv: e-mail statistic ids, per-contact event details, list members. - [MCP server for AI assistants](https://www.postarna.sk/docs/api/reference-mcp): Model Context Protocol over Streamable HTTP (JSON-RPC 2.0). Tools map to API v1 routes; sending, deleting and other irreversible actions need a preview and a confirm token. - [OAuth 2.1 for AI assistants](https://www.postarna.sk/docs/api/reference-oauth): Dynamic client registration, authorization code with PKCE, tokens and revocation, server metadata. Used by MCP clients; integrations use API keys instead. - [This document](https://www.postarna.sk/docs/api/reference-meta): The OpenAPI document itself. - [História zmien](https://www.postarna.sk/docs/api/changelog): Zmeny API a dokumentácie. ## OpenAPI - [openapi.json](https://www.postarna.cz/api/openapi.json): OpenAPI 3.1, všetky operácie a schémy ## Optional - [llms-full.txt](https://www.postarna.sk/llms-full.txt): tento prehľad, popis produktu a všetky návody API dokumentácie v jednom súbore Markdown - [Obchodné podmienky služby Poštárna](https://www.postarna.sk/terms): Verzia 1.1, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o. - [Reklamačný poriadok a podpora služby Poštárna](https://www.postarna.sk/claims): Verzia 1.0, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o. - [Zmluva o spracúvaní osobných údajov](https://www.postarna.sk/dpa): Verzia 1.0, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o. - [Zásady používania a pravidlá rozosielania](https://www.postarna.sk/acceptable-use): Verzia 1.0, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o. - [Zásady ochrany osobných údajov služby Poštárna](https://www.postarna.sk/privacy): Verzia 1.0, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o. - [Zásady používania cookies](https://www.postarna.sk/cookies): Verzia 1.0, účinná od 12. 10. 2026, prevádzkovateľ deriverge s.r.o.