# Poštárna > Poštárna je česká platforma pro e-mail marketing: hromadné rozesílky, automatizace a statistiky, které ukážou, co každý e-mail vydělal. Pro firmy i e-shopy v Česku a na Slovensku, aplikace i podpora česky a slovensky. Provozovatel deriverge s.r.o., IČ 19456361. - Magic Editor: Bloky přetáhnete myší, na telefonu je vložíte klepnutím. Editor ukládá sám. - Automatizace: Scénář poskládáte na plátně a před spuštěním ho vyzkoušíte nanečisto. Nic přitom neodejde. - Uvidíte, co každý e-mail vydělal. Doručení, otevření, kliky i objednávky u každé kampaně a každého e-mailu automatizace. - Pro e-shopy: Produkty z feedu, Opuštěný košík, Objednávky ve statistikách, Kupte si znovu, CZ a SK v jedné kampani. - Přechod ze SmartEmailingu: Stačí API klíč. Poštárna ze SmartEmailingu jen čte a nic v něm nemění. - Ceník: Platíte podle počtu kontaktů. Bez závazků, měsíčně nebo ročně. Ceny jsou bez DPH. Automatizace, feedy, kupóny, formuláře, landing pages, statistiky i podpora v každém tarifu. Aktuální ceník (JSON): https://www.postarna.cz/api/v1/public/price-list - API: API v1 (`/api/v1/tenants/{tenant}/...`) je úplné API, které používá i webová aplikace; API v3 (`/api/v3/...`) je kompatibilní se SmartEmailingem; server MCP (`/mcp`) slouží AI asistentům. Přihlášení API klíčem: `Authorization: Bearer pst_...`. - Celý strojově čitelný popis API: https://www.postarna.cz/api/openapi.json (OpenAPI 3.1). Jen jedna skupina: `?tag=Automations` (názvy skupin v poli `tags`). - Před odesláním skutečným příjemcům (schválení kampaně, zapnutí automatizace) vždy nejdřív spočítejte příjemce a ověřte nastavení: kampaň `POST /campaigns/audience`, automatizace `POST /automations/validate` a `POST /automations/{id}/test`. ## Produkt - [Poštárna](https://www.postarna.cz/): Hromadné rozesílky, automatizace a podrobné statistiky pro firmy všech velikostí. Magic Editor, segmenty, unikátní slevové kódy, svátky a narozeniny, napojení na e-shop i přechod ze SmartEmailingu. Česky a slovensky. - [Funkce](https://www.postarna.cz/#features): Napište e-mail, který vypadá skvěle. Pošlete ho přesně těm, koho se týká. A uvidíte, co vám vydělal. - [Automatizace](https://www.postarna.cz/#automation): Scénář poskládáte na plátně a před spuštěním ho vyzkoušíte nanečisto. Nic přitom neodejde. - [Přechod ze SmartEmailingu](https://www.postarna.cz/#switch): Stačí API klíč. Poštárna ze SmartEmailingu jen čte a nic v něm nemění. - [Ceník](https://www.postarna.cz/#pricing): Platíte podle počtu kontaktů. Bez závazků, měsíčně nebo ročně. Ceny jsou bez DPH. - [Aktuální ceník (JSON)](https://www.postarna.cz/api/v1/public/price-list): tarify podle počtu kontaktů s měsíční cenou bez DPH, roční sleva, zkušební doba a limity bezplatného tarifu, přímo z ceníku aplikace - [Časté otázky](https://www.postarna.cz/#faq): odpovědi na otázky: Kdo Poštárnu provozuje? Hodí se Poštárna pro moji firmu? Z jaké adresy se e-maily odesílají? Jak přejdu ze SmartEmailingu? Jak Poštárna nakládá s osobními údaji? Kde najdu pomoc? ## Návody a zdroje - [Ceník Poštárny](https://www.postarna.cz/cenik): Aktuální ceník Poštárny: tarify podle počtu kontaktů, měsíční cena bez DPH, roční sleva a zkušební doba. Všechny funkce v každém tarifu. - [Návody pro e-mail marketing](https://www.postarna.cz/navody): Praktické návody krok za krokem: první newsletter, opuštěný košík, e-maily ke svátku, win-back, formulář s double opt-in, přechod ze SmartEmailingu, SPF, DKIM a DMARC a segmentace zákazníků. - [Jak poslat první newsletter](https://www.postarna.cz/navody/prvni-newsletter): Od ověření domény přes import kontaktů a šablonu v editoru po testovací e-mail a odeslání kampaně. První newsletter v Poštárně krok za krokem. - [Opuštěný košík krok za krokem](https://www.postarna.cz/navody/opusteny-kosik): Jak napojit e-shop na Shoptetu jedním řádkem v patičce a poslat zákazníkovi připomenutí košíku dvě hodiny po poslední změně, jen když neobjednal. - [E-maily ke svátku a narozeninám](https://www.postarna.cz/navody/svatky-a-narozeniny): Automatické přání ke svátku nebo narozeninám se správným oslovením v 5. pádě a jednorázovým slevovým kódem. Český i slovenský kalendář jmen. - [Win-back kampaň pro neaktivní zákazníky](https://www.postarna.cz/navody/win-back): Jak automaticky oslovit zákazníky, kteří dlouho nenakoupili: připomenutí, druhý e-mail s výhodou a konec série pro ty, kdo mezitím nakoupí. - [Formulář s potvrzením odběru (double opt-in)](https://www.postarna.cz/navody/formular-double-opt-in): Přihlašovací formulář na web nebo jako pop-up, s potvrzením odběru e-mailem a doloženým souhlasem podle GDPR. Postup v Poštárně. - [Přechod ze SmartEmailingu do Poštárny](https://www.postarna.cz/navody/prechod-ze-smartemailingu): Jak sami přenést kontakty, seznamy, odhlášení, souhlasy, šablony a automatizace ze SmartEmailingu do Poštárny. Stačí API klíč, ve SmartEmailingu se nic nezmění. - [Lepší doručitelnost se SPF, DKIM a DMARC](https://www.postarna.cz/navody/spf-dkim-dmarc): Proč e-maily padají do spamu a jak to opravit: ověření domény přes DKIM, záznam SPF a DMARC, postupné zvyšování objemu a čistá databáze. Návod pro Poštárnu. - [Segmentace zákazníků v e-mailingu](https://www.postarna.cz/navody/segmentace-zakazniku): Jak rozdělit kontakty podle nákupů, aktivity a souhlasů a posílat každé skupině to, co ji zajímá. Příklady segmentů pro e-shopy a postup v Poštárně. - [Slovník pojmů e-mail marketingu](https://www.postarna.cz/slovnik): Co znamená double opt-in, míra otevření, CTR, soft a hard bounce, SPF, DKIM, DMARC, segment, opuštěný košík nebo win-back. Krátké definice a jak to řeší Poštárna. - [Integrace Poštárny](https://www.postarna.cz/integrace): Napojení Poštárny na Shoptet, produktové feedy Google Merchant, Heureka a Zboží.cz, RSS, import CSV, webhooky, API, API kompatibilní se SmartEmailingem a MCP pro AI asistenty. ## API dokumentace: Začínáme - [API dokumentace Poštárny](https://www.postarna.cz/docs/api): Co API Poštárny umí, jak je dokumentace uspořádaná a kde začít. - [Začínáme](https://www.postarna.cz/docs/api/getting-started): API klíč, ID firmy a první volání API za pět minut. - [Pravidla API](https://www.postarna.cz/docs/api/conventions): Formáty dat, stránkování, řazení, chyby, limity požadavků, opakování a souběžné úpravy. ## API dokumentace: Koncepty - [Firma a e-shopy](https://www.postarna.cz/docs/api/tenants-and-shops): Firma (tenant), její e-shopy s měnou a jazykem, časová zóna a izolace dat. - [Kontakty a souhlasy](https://www.postarna.cz/docs/api/contacts-and-consent): Kontakt a jeho stavy, souhlasy a účely zpracování, potlačení a blacklist, komu Poštárna smí psát. - [Seznamy a segmenty](https://www.postarna.cz/docs/api/lists-and-segments): Kdy použít seznam a kdy segment, stavy členství, jazyk podmínek segmentů a živý náhled počtu. - [Šablony a personalizace](https://www.postarna.cz/docs/api/templates-and-personalization): Šablony e-mailů, obsah a verze, kontrola obsahu, zástupné značky, skripty Twig, kupóny a data objednávek. - [Kampaně](https://www.postarna.cz/docs/api/campaigns): Životní cyklus kampaně, publikum a jeho výpočet, schválení s počtem příjemců, plánování, pauza a zrušení. - [Automatizace](https://www.postarna.cz/docs/api/automations): Model grafu, uzly a výstupy, spouštěče, jazyk podmínek, čekání, validace, zapnutí, uložení běžícího scénáře, verze a testování. - [Reference automatizací](https://www.postarna.cz/docs/api/automation-reference): Přesná schémata všech uzlů automatizace, událostí, podmínek, pravidel segmentů a časových údajů s ověřenými příklady. - [Objednávky, feedy a kupóny](https://www.postarna.cz/docs/api/orders-feeds-coupons): Zápis objednávek a mapa stavů, produktové, zákaznické a objednávkové feedy, zásobníky slevových kupónů a konverze. ## API dokumentace: Recepty - [Recept: opuštěný košík](https://www.postarna.cz/docs/api/recipe-abandoned-cart): Automatizace, která za 2 hodiny připomene neodeslaný košík, s událostmi košíku posílanými z e-shopu. - [Recept: série po nákupu](https://www.postarna.cz/docs/api/recipe-post-purchase): Poděkování a prosba o hodnocení 3 dny po dokončené objednávce, tip na přípravu těm, kdo neklikli. - [Recept: svátky se slevou](https://www.postarna.cz/docs/api/recipe-name-days): Každý den v 8:00 popřát kontaktům, které mají svátek, a dát jim jednorázový slevový kód. - [Recept: návrat neaktivních zákazníků](https://www.postarna.cz/docs/api/recipe-win-back): Zákazníkům 120 dní bez nákupu poslat připomenutí a po týdnu druhé, pokud mezitím nenakoupí. - [Recept: přihlašovací formulář s potvrzením](https://www.postarna.cz/docs/api/recipe-double-opt-in): Formulář s double opt-in na web, seznam odběratelů, souhlas s účelem a uvítací e-mail po potvrzení. - [Recept: import kontaktů z CSV](https://www.postarna.cz/docs/api/recipe-import-contacts): Nahrání CSV, náhled mapování a problémů, spuštění importu s doloženým souhlasem a sledování průběhu. - [Recept: odeslání kampaně](https://www.postarna.cz/docs/api/recipe-send-campaign): Koncept kampaně, obsah, kontrola obsahu, počet příjemců, testovací e-mail, schválení s plánovaným časem a zrušení. - [Recept: příjem webhooků](https://www.postarna.cz/docs/api/recipe-webhook-consumer): Registrace účtových webhooků, ověření Basic, idempotentní zpracování a ukázkový příjemce v Pythonu a Node.js. ## API dokumentace: Integrace - [Webhooky](https://www.postarna.cz/docs/api/webhooks): Účtové webhooky (nový kontakt, odhlášení, doručení, otevření, klik), tvar dat, doručování a opakování, zabezpečení a webhook v automatizaci. - [MCP pro AI asistenty](https://www.postarna.cz/docs/api/mcp): Připojení ChatGPT, Claude a dalších klientů k serveru MCP Poštárny, rozsahy přístupu, nástroje a povinné potvrzení před odesláním. - [Kompatibilita se SmartEmailingem](https://www.postarna.cz/docs/api/smartemailing): API v3 a CSV statistiky se stejnými cestami, obálkami a chybami jako SmartEmailing, přihlášení, limity a rozdíly. ## API dokumentace: Reference API - [Přehled operací](https://www.postarna.cz/docs/api/reference): Všechny operace API po skupinách s odkazy na podrobnou referenci a strojově čitelný dokument OpenAPI. - [Chyby a limity](https://www.postarna.cz/docs/api/errors-and-limits): Každý kód chyby s významem a nápravou, HTTP stavy, limity požadavků a limity jednotlivých akcí. - [Contacts](https://www.postarna.cz/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.cz/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.cz/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.cz/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.cz/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.cz/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.cz/docs/api/reference-forms): Sign-up forms (double opt-in): builder settings, embed code, history. - [Imports and exports](https://www.postarna.cz/docs/api/reference-imports-and-exports): CSV import of contacts (upload, preview, run) and CSV exports. - [Orders, feeds and coupons](https://www.postarna.cz/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.cz/docs/api/reference-statistics): E-mail statistics of campaigns and automations, dashboard, conversions. - [Sending and deliverability](https://www.postarna.cz/docs/api/reference-sending): Senders, sending domains (SPF, DKIM, DMARC), DMARC reports, sending mode. - [Account and settings](https://www.postarna.cz/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.cz/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.cz/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.cz/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.cz/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.cz/docs/api/reference-meta): The OpenAPI document itself. - [Historie změn](https://www.postarna.cz/docs/api/changelog): Změny API a dokumentace. ## OpenAPI - [openapi.json](https://www.postarna.cz/api/openapi.json): OpenAPI 3.1, všechny operace a schémata ## Optional - [llms-full.txt](https://www.postarna.cz/llms-full.txt): tento přehled, popis produktu a všechny návody API dokumentace v jednom souboru Markdown - [Obchodní podmínky služby Poštárna](https://www.postarna.cz/terms): Verze 1.1, účinná od 12. 10. 2026, provozovatel deriverge s.r.o. - [Reklamační řád a podpora služby Poštárna](https://www.postarna.cz/claims): Verze 1.0, účinná od 12. 10. 2026, provozovatel deriverge s.r.o. - [Smlouva o zpracování osobních údajů](https://www.postarna.cz/dpa): Verze 1.0, účinná od 12. 10. 2026, provozovatel deriverge s.r.o. - [Zásady používání a pravidla rozesílání](https://www.postarna.cz/acceptable-use): Verze 1.0, účinná od 12. 10. 2026, provozovatel deriverge s.r.o. - [Zásady ochrany osobních údajů služby Poštárna](https://www.postarna.cz/privacy): Verze 1.0, účinná od 12. 10. 2026, provozovatel deriverge s.r.o. - [Zásady používání cookies](https://www.postarna.cz/cookies): Verze 1.0, účinná od 12. 10. 2026, provozovatel deriverge s.r.o.