Sending and deliverability

Senders, sending domains (SPF, DKIM, DMARC), DMARC reports, sending mode.

Technická referencia je v angličtine (rovnako ako strojovo čitateľný dokument OpenAPI). Celú skupinu pre AI agenta načítate z /api/openapi.json?tag=Sending.

Prihlásenie: Authorization: Bearer pst_... alebo HTTP Basic (e-mail člena firmy a API kľúč).

Operácie

Metóda	Cesta	Popis
GET	`/api/v1/tenants/{tenant}/deliverability/dmarc`	DMARC summary
GET	`/api/v1/tenants/{tenant}/deliverability/dmarc/report`	DMARC report detail
GET	`/api/v1/tenants/{tenant}/deliverability/domains`	List domains with their DNS state
POST	`/api/v1/tenants/{tenant}/deliverability/domains`	Add a domain
PATCH	`/api/v1/tenants/{tenant}/deliverability/domains/{domain_id}`	Update a domain
DELETE	`/api/v1/tenants/{tenant}/deliverability/domains/{domain_id}`	Delete a domain
POST	`/api/v1/tenants/{tenant}/deliverability/domains/{domain_id}/check`	Check the DNS records of a domain now
GET	`/api/v1/tenants/{tenant}/deliverability/senders`	Senders with their authentication state
GET	`/api/v1/tenants/{tenant}/sending-defaults`	Get the default settings of new campaigns (tracking parameters on or off)
PUT	`/api/v1/tenants/{tenant}/sending-defaults`	Set whether new campaigns start with tracking parameters
GET	`/api/v1/tenants/{tenant}/sending-mode`	Sending mode of the company (switch, limits)
POST	`/api/v1/tenants/{tenant}/sending/domains`	Add a sending domain
DELETE	`/api/v1/tenants/{tenant}/sending/domains/{domain_id}`	Delete a sending domain
POST	`/api/v1/tenants/{tenant}/sending/domains/{domain_id}/check`	Check a sending domain
POST	`/api/v1/tenants/{tenant}/sending/senders`	Add a sender
PATCH	`/api/v1/tenants/{tenant}/sending/senders/{sender_id}`	Update a sender
DELETE	`/api/v1/tenants/{tenant}/sending/senders/{sender_id}`	Delete a sender
POST	`/api/v1/tenants/{tenant}/sending/senders/{sender_id}/check`	Check whether a sender address is confirmed
POST	`/api/v1/tenants/{tenant}/sending/senders/{sender_id}/resend`	Send the confirmation e-mail of a sender address again
GET	`/api/v1/tenants/{tenant}/sending/senders/{sender_id}/usage`	Where a sender is used
GET	`/api/v1/tenants/{tenant}/sending/setup`	State of the sending setup (domains and senders)

DMARC summary

GET /api/v1/tenants/{tenant}/deliverability/dmarc

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json DmarcSummary

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

DMARC report detail

GET /api/v1/tenants/{tenant}/deliverability/dmarc/report

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

SE Statistiky › DMARC: ?from=&to= (calendar days of the tenant, both included; none = the whole history), ?domain= (sending domain id), ?reporter= (the provider's org name).

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain`	query	string	nie
`from`	query	string	nie	Start of the period (YYYY-MM-DD local day, or ISO time where noted).
`reporter`	query	string	nie
`to`	query	string	nie	End of the period (YYYY-MM-DD local day, or ISO time where noted).

Odpovede

200 OK: application/json DmarcReport

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	to
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

List domains with their DNS state

GET /api/v1/tenants/{tenant}/deliverability/domains

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json SendingDomainList

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Add a domain

POST /api/v1/tenants/{tenant}/deliverability/domains

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Telo požiadavky (application/json): Required by the server: domain.

Pole	Typ	Povinné	Popis
`domain`	string	áno
`dkimSelectors`	array of string	nie

Odpovede

201 Created: application/json SendingDomain

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Update a domain

PATCH /api/v1/tenants/{tenant}/deliverability/domains/{domain_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain_id`	path	string	áno	Id of the domain (string of digits).

Telo požiadavky (application/json): Required by the server: dkimSelectors.

Pole	Typ	Povinné	Popis
`dkimSelectors`	array of string	áno

Odpovede

200 OK: application/json SendingDomain

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
429		429 rate_limited: wait Retry-After seconds.

Delete a domain

DELETE /api/v1/tenants/{tenant}/deliverability/domains/{domain_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain_id`	path	string	áno	Id of the domain (string of digits).

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
429		429 rate_limited: wait Retry-After seconds.

Check the DNS records of a domain now

POST /api/v1/tenants/{tenant}/deliverability/domains/{domain_id}/check

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain_id`	path	string	áno	Id of the domain (string of digits).

Odpovede

200 OK: application/json SendingDomain

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
429		429 rate_limited: wait Retry-After seconds.
503	`unavailable`	dns

Senders with their authentication state

GET /api/v1/tenants/{tenant}/deliverability/senders

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Get the default settings of new campaigns (tracking parameters on or off)

GET /api/v1/tenants/{tenant}/sending-defaults

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

SE Nastavení › Rozesílky › Výchozí nastavení beyond what other routes keep (senders, test recipients, the default unsubscribe page): {utmDefaultOn} = new campaign drafts start with the tracking parameters on.

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json SendingDefaults

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Set whether new campaigns start with tracking parameters

PUT /api/v1/tenants/{tenant}/sending-defaults

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Body {utmDefaultOn: bool} (SE UTM Parametry Nesledovat / Sledovat). Audited as setting_changed.

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Telo požiadavky (application/json): Required by the server: utmDefaultOn.

Pole	Typ	Povinné	Popis
`utmDefaultOn`	boolean	áno

Odpovede

200 OK: application/json SendingDefaults

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	utmDefaultOn
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Sending mode of the company (switch, limits)

GET /api/v1/tenants/{tenant}/sending-mode

Oprávnenie: modul null, úroveň read; kľúč s prístupom read alebo full

What leaves Poštárna for this tenant now (core/backends.mode_of): live (everything), test (only test e-mails to the test whitelist, POSTARNA_SES_LIVE=test), folder (development: files, nothing leaves) or off (nothing). testRecipients = how many addresses the test whitelist has. sendingEnabled = the tenant's kill switch (setting sending_enabled, python -m postarna.admin sending-switch): while it is off no sending tick runs, so no campaign goes out and no automation lets anybody in, whatever the mode says (test e-mails still go out). sendingState = the platform's approval of live sending (pending, live, paused, suspended; migration 0170) and sendingHold why a live tenant is held ('', platform, free_limit, unpaid).

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json SendingModeInfo

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Add a sending domain

POST /api/v1/tenants/{tenant}/sending/domains

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Telo požiadavky (application/json): Required by the server: domain.

Pole	Typ	Povinné	Popis
`domain`	string	áno

Odpovede

201 Created: application/json SetupDomain

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Delete a sending domain

DELETE /api/v1/tenants/{tenant}/sending/domains/{domain_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain_id`	path	string	áno	Id of the domain (string of digits).

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Check a sending domain

POST /api/v1/tenants/{tenant}/sending/domains/{domain_id}/check

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`domain_id`	path	string	áno	Id of the domain (string of digits).

Odpovede

200 OK: application/json SetupDomain

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
429		429 rate_limited: wait Retry-After seconds.

Add a sender

POST /api/v1/tenants/{tenant}/sending/senders

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Poznámky kontraktu (cs): Přidání {shopId, email, name?, replyTo?, isDefault?} jen na ověřené doméně (400 validation / email, reason domain_not_verified nebo freemail; 409 conflict pro stejnou adresu v e-shopu). První adresa e-shopu je výchozí. Adresa, kterou účet dřív odebral, se stejným přidáním vrátí (stejné id, nové jméno a replyTo).

Úprava (PATCH) {name?, replyTo?, isDefault: true?} → SetupSender. name = jméno odesílatele (Od koho), nejvýš 100 znaků bez < > { } " a řádků (400 validation / name). replyTo = adresa pro odpovědi nebo "" (odpovědi pak přijdou na adresu odesílatele); co není adresa, odmítne 400 validation / replyTo (nikdy se tiše nevyprázdní). Samotnou adresu email změnit nejde (patří k ověřené doméně): jiná hodnota než uložená = 400 validation / email s reason read_only.
Odebrání (DELETE) 204. Odmítne 409 conflict / id s reason default (výchozí adresa e-shopu) nebo in_use (adresu používá kampaň ve stavu scheduled, sending nebo paused, nebo krok E-mail automatizace ve stavu active nebo paused). Koncepty a skončené kampaně odebrání nebrání. Řádek zůstává (senders.removed_at, migrace 0096): skončené kampaně a automatizace si odkaz na odesílatele ponechají, ze všech seznamů a výběrů (GET …/sending/setup, GET /tenants/{t}/senders, výběr v kampani a automatizaci, schválení) adresa zmizí; koncept s odebranou adresou schválení odmítne 400 validation / senderId. Další PATCH nebo DELETE odebrané adresy = 404 not_found.
Modul settings full, změny zapisují audit (sender_added, sender_updated s názvy polí, sender_deleted).

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Telo požiadavky (application/json): Required by the server: email, shopId.

Pole	Typ	Povinné
`shopId`	string	áno
`email`	string	áno
`name`	string	nie
`replyTo`	string	nie
`isDefault`	boolean	nie

Odpovede

201 Created: application/json SetupSender

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Update a sender

PATCH /api/v1/tenants/{tenant}/sending/senders/{sender_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Úprava (PATCH) {name?, replyTo?, isDefault: true?} → SetupSender. name = jméno odesílatele (Od koho), nejvýš 100 znaků bez < > { } " a řádků (400 validation / name). replyTo = adresa pro odpovědi nebo "" (odpovědi pak přijdou na adresu odesílatele); co není adresa, odmítne 400 validation / replyTo (nikdy se tiše nevyprázdní). Samotnou adresu email změnit nejde (patří k ověřené doméně): jiná hodnota než uložená = 400 validation / email s reason read_only.
Odebrání (DELETE) 204. Odmítne 409 conflict / id s reason default (výchozí adresa e-shopu) nebo in_use (adresu používá kampaň ve stavu scheduled, sending nebo paused, nebo krok E-mail automatizace ve stavu active nebo paused). Koncepty a skončené kampaně odebrání nebrání. Řádek zůstává (senders.removed_at, migrace 0096): skončené kampaně a automatizace si odkaz na odesílatele ponechají, ze všech seznamů a výběrů (GET …/sending/setup, GET /tenants/{t}/senders, výběr v kampani a automatizaci, schválení) adresa zmizí; koncept s odebranou adresou schválení odmítne 400 validation / senderId. Další PATCH nebo DELETE odebrané adresy = 404 not_found.
Modul settings full, změny zapisují audit (sender_added, sender_updated s názvy polí, sender_deleted).

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`sender_id`	path	string	áno	Id of the sender (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`name`	string	nie	From name, at most 100 characters without < > { } " and line breaks.
`replyTo`	string	nie	Address for replies, '' = replies go to the sender address.
`isDefault`	`true`	nie

Odpovede

200 OK: application/json SetupSender

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Delete a sender

DELETE /api/v1/tenants/{tenant}/sending/senders/{sender_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

204; 409 conflict default / in_use; ?replacementId= (SE's Náhradní adresa, DO-03) first moves the shop's default, the unfinished campaigns and the automation e-mail steps to that sender of the same shop.

Úprava (PATCH) {name?, replyTo?, isDefault: true?} → SetupSender. name = jméno odesílatele (Od koho), nejvýš 100 znaků bez < > { } " a řádků (400 validation / name). replyTo = adresa pro odpovědi nebo "" (odpovědi pak přijdou na adresu odesílatele); co není adresa, odmítne 400 validation / replyTo (nikdy se tiše nevyprázdní). Samotnou adresu email změnit nejde (patří k ověřené doméně): jiná hodnota než uložená = 400 validation / email s reason read_only.
Odebrání (DELETE) 204. Odmítne 409 conflict / id s reason default (výchozí adresa e-shopu) nebo in_use (adresu používá kampaň ve stavu scheduled, sending nebo paused, nebo krok E-mail automatizace ve stavu active nebo paused). Koncepty a skončené kampaně odebrání nebrání. Řádek zůstává (senders.removed_at, migrace 0096): skončené kampaně a automatizace si odkaz na odesílatele ponechají, ze všech seznamů a výběrů (GET …/sending/setup, GET /tenants/{t}/senders, výběr v kampani a automatizaci, schválení) adresa zmizí; koncept s odebranou adresou schválení odmítne 400 validation / senderId. Další PATCH nebo DELETE odebrané adresy = 404 not_found.
Modul settings full, změny zapisují audit (sender_added, sender_updated s názvy polí, sender_deleted).

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`sender_id`	path	string	áno	Id of the sender (string of digits).
`replacementId`	query	string	nie

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	replacementId
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Check whether a sender address is confirmed

POST /api/v1/tenants/{tenant}/sending/senders/{sender_id}/check

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Zkontrolovat of an address confirmed through SES (DO-03): reads the state of its identity.

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`sender_id`	path	string	áno	Id of the sender (string of digits).

Odpovede

200 OK: application/json SetupSender

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Send the confirmation e-mail of a sender address again

POST /api/v1/tenants/{tenant}/sending/senders/{sender_id}/resend

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full

Poslat znovu the confirmation e-mail of an address verified by e-mail (DO-03); 409 when it is verified already, 503 unavailable when no e-mail could go out.

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`sender_id`	path	string	áno	Id of the sender (string of digits).

Odpovede

200 OK: application/json SetupSender

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
409	`conflict`	verified
429		429 rate_limited: wait Retry-After seconds.
503	`unavailable`	email

Where a sender is used

GET /api/v1/tenants/{tenant}/sending/senders/{sender_id}/usage

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

Where a sender is used (SE "Použití odesílací adresy" before Smazat adresu): {items: [{type, id, name, status}]}, type default (its shop's default sender), campaign or automation.

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.
`sender_id`	path	string	áno	Id of the sender (string of digits).

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
404	`not_found`
429		429 rate_limited: wait Retry-After seconds.

State of the sending setup (domains and senders)

GET /api/v1/tenants/{tenant}/sending/setup

Oprávnenie: modul settings, úroveň read; kľúč s prístupom read alebo full

Parametre

Názov	Kde	Typ	Povinné	Popis
`tenant`	path	string (uuid)	áno	Public id of the company (tenant), a UUID: GET /api/v3/account-info answers it as data.guid; the app shows it on the API keys page.

Odpovede

200 OK: application/json SendingSetup

Chyby

Stav	Kód	Hodnoty `message`
401		401 unauthorized: missing, unknown, revoked, expired or idle API key.
403		403 forbidden: message tenant (another company), scope (read-only key), api_key (person only), or the module the key's roles lack.
429		429 rate_limited: wait Retry-After seconds.

Schémy

DmarcReport

Pole	Typ	Povinné
`totals`	object	áno
`domains`	array of object	áno
`days`	array of object	áno
`ips`	array of object	áno
`ipVersions`	object	áno
`reporters`	array of object	áno
`dispositions`	array of object	áno
`cases`	array of object	áno
`reporterChoices`	array of string	áno
`domainChoices`	array of object	áno

DmarcSummary

Pole	Typ	Povinné
`days`	number	áno
`domains`	array of object	áno
`sources`	array of object	áno
`reports`	array of object	áno
`complaints`	object	áno

Error

Pole	Typ	Povinné	Popis
`error`	object	áno

json

{
  "error": {
    "code": "validation",
    "message": "email"
  }
}

SenderAuth

Pole	Typ	Povinné
`id`	string	áno
`shopId`	string	áno
`name`	string	áno
`email`	string	áno
`replyTo`	string	áno
`domain`	string	áno
`domainId`	string or null	áno
`verified`	boolean	áno
`isDefault`	boolean	áno
`freemail`	boolean	áno
`spf`	one of: `ok`, `invalid`, `error`, `unknown`, `missing`	áno
`dkim`	one of: `ok`, `invalid`, `error`, `unknown`, `missing`	áno
`dmarc`	one of: `ok`, `invalid`, `error`, `unknown`, `missing`	áno
`usableAsSender`	boolean	áno

SenderUsage

One use of a sender (GET /sending/senders/{id}/usage). type default: the default sender of shop id.

Pole	Typ	Povinné
`type`	one of: `campaign`, `automation`, `default`	áno
`id`	string	áno
`name`	string	áno
`status`	string	áno

SendingDefaults

GET/PUT /tenants/{t}/sending-defaults (SE Výchozí nastavení, DO-07): utmDefaultOn = new drafts start with the tracking parameters utm_source newsletter and utm_medium email.

Pole	Typ	Povinné	Popis
`utmDefaultOn`	boolean	áno

SendingDomain

Pole	Typ	Povinné	Popis
`id`	string	áno
`domain`	string	áno
`dkimSelectors`	array of string	áno
`spf`	object	áno
`dkim`	object	áno
`dmarc`	object	áno
`issues`	array of string	áno	Codes, texts in the catalogs (deliverability.issue.<code>).
`checkedAt`	string or null	áno
`createdAt`	string	áno

SendingDomainInput

Pole	Typ	Povinné	Popis
`domain`	string	áno
`dkimSelectors`	array of string	nie

SendingDomainList

Pole	Typ	Povinné	Popis
`items`	array of SendingDomain	áno
`suggestions`	array of string	áno	Domains of sender addresses without a sending domain yet.

SendingMode

one of: live, test, folder, off

SendingModeInfo

Pole	Typ	Povinné	Popis
`mode`	SendingMode	áno
`testRecipients`	number	áno	How many addresses the tenant's test list has.
`sendingEnabled`	boolean	nie	The tenant's kill switch: off = no campaign goes out and no automation lets anybody in (tests still go out).
`sendingState`	one of: `suspended`, `pending`, `live`, `paused`	nie	The platform's approval (B4): anything but live keeps the tenant to test e-mails.
`sendingHold`	one of: `, free_limit`,` unpaid`,` platform`	nie	Why a live tenant is held: the platform switch or billing (free tier used up, unpaid invoice).

SendingSetup

Pole	Typ	Povinné	Popis
`managed`	boolean	áno	The tenant sends through the platform account (Poštárna creates the identity).
`platformReady`	boolean	áno	false = the platform still has to finish its part (no identity credential).
`domains`	array of SetupDomain	áno
`suggestions`	array of string	áno
`shops`	array of object	áno
`senders`	array of SetupSender	áno
`advanced`	object	nie	Platform admins only.

SetupDnsRecord

Pole	Typ	Povinné	Popis
`kind`	one of: `dkim`, `spf`, `dmarc`	áno
`type`	one of: `CNAME`, `TXT`	áno
`host`	string	áno	Name without the domain (what most DNS hosts ask for); '@' = the domain itself.
`name`	string	áno	Full name.
`value`	string	áno
`required`	boolean	áno
`status`	SetupRecordStatus	áno

SetupDomain

Pole	Typ	Povinné	Popis
`id`	string	áno
`domain`	string	áno
`state`	SetupDomainState	áno
`records`	array of SetupDnsRecord	áno
`checkedAt`	string or null	áno
`createdAt`	string	áno
`advanced`	object	nie	Platform admins only.

SetupDomainState

one of: pending, failed, verified, setup

SetupRecordStatus

one of: ok, unknown, missing

SetupSender

Pole	Typ	Povinné	Popis
`id`	string	áno
`shopId`	string	áno
`name`	string	áno
`email`	string	áno
`replyTo`	string	áno
`isDefault`	boolean	áno
`verified`	boolean	áno
`domainVerified`	boolean	áno
`verifyMethod`	one of: `domain`, `email`	nie	DO-03: domain = verified by the DKIM of its domain, email = confirmed (or waiting for) a confirmation e-mail.
`verificationSentAt`	string or null	nie	When the last confirmation e-mail went out; null = none could be sent.
`freemail`	boolean	nie	An address of a free mailbox service (its provider's DMARC fails for e-mails sent through Poštárna).

SetupSenderInput

Pole	Typ	Povinné
`shopId`	string	áno
`email`	string	áno
`name`	string	nie
`replyTo`	string	nie
`isDefault`	boolean	nie

SetupSenderPatch

Edit of an existing sender. The address itself never changes (it belongs to a verified domain; server 400 validation email, reason read_only).

Pole	Typ	Povinné	Popis
`name`	string	nie	From name, at most 100 characters without < > { } " and line breaks.
`replyTo`	string	nie	Address for replies, '' = replies go to the sender address.
`isDefault`	`true`	nie

Sending and deliverability

Operácie#

DMARC summary#

DMARC report detail#

List domains with their DNS state#

Add a domain#

Update a domain#

Delete a domain#

Check the DNS records of a domain now#

Senders with their authentication state#

Get the default settings of new campaigns (tracking parameters on or off)#

Set whether new campaigns start with tracking parameters#

Sending mode of the company (switch, limits)#

Add a sending domain#

Delete a sending domain#

Check a sending domain#

Add a sender#

Update a sender#

Delete a sender#

Check whether a sender address is confirmed#

Send the confirmation e-mail of a sender address again#

Where a sender is used#

State of the sending setup (domains and senders)#

Schémy#

DmarcReport#

DmarcSummary#

Error#

SenderAuth#

SenderUsage#

SendingDefaults#

SendingDomain#

SendingDomainInput#

SendingDomainList#

SendingMode#

SendingModeInfo#

SendingSetup#

SetupDnsRecord#

SetupDomain#

SetupDomainState#

SetupRecordStatus#

SetupSender#

SetupSenderInput#

SetupSenderPatch#

Operácie

DMARC summary

DMARC report detail

List domains with their DNS state

Add a domain

Update a domain

Delete a domain

Check the DNS records of a domain now

Senders with their authentication state

Get the default settings of new campaigns (tracking parameters on or off)

Set whether new campaigns start with tracking parameters

Sending mode of the company (switch, limits)

Add a sending domain

Delete a sending domain

Check a sending domain

Add a sender

Update a sender

Delete a sender

Check whether a sender address is confirmed

Send the confirmation e-mail of a sender address again

Where a sender is used

State of the sending setup (domains and senders)

Schémy

DmarcReport

DmarcSummary

Error

SenderAuth

SenderUsage

SendingDefaults

SendingDomain

SendingDomainInput

SendingDomainList

SendingMode

SendingModeInfo

SendingSetup

SetupDnsRecord

SetupDomain

SetupDomainState

SetupRecordStatus

SetupSender

SetupSenderInput

SetupSenderPatch