Account and settings

Shops (e-shops) of the company, company data, consent settings, notifications, labels, web tracking, billing (read), SmartEmailing migration state.

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=Account.

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

Operácie

Metóda	Cesta	Popis
GET	`/api/v1/public/price-list`	Public price list (no authentication)
GET	`/api/v1/tenants/{tenant}/account-webhooks`	List account webhooks and their events
POST	`/api/v1/tenants/{tenant}/account-webhooks`	Create an account webhook
PATCH	`/api/v1/tenants/{tenant}/account-webhooks/{webhook_id}`	Edit, switch off or on an account webhook
DELETE	`/api/v1/tenants/{tenant}/account-webhooks/{webhook_id}`	Delete an account webhook
POST	`/api/v1/tenants/{tenant}/account-webhooks/{webhook_id}/test`	Send a test call of an account webhook now
GET	`/api/v1/tenants/{tenant}/billing`	Tariff, usage and balance
GET	`/api/v1/tenants/{tenant}/billing/cancel`	What cancelling the tariff would mean
GET	`/api/v1/tenants/{tenant}/billing/invoices`	List invoices
GET	`/api/v1/tenants/{tenant}/billing/invoices/{invoice_id}/pdf`	Download an invoice (PDF)
GET	`/api/v1/tenants/{tenant}/billing/invoices/{invoice_id}/qr.svg`	QR payment code of an invoice (SVG)
GET	`/api/v1/tenants/{tenant}/billing/payments`	List payments
GET	`/api/v1/tenants/{tenant}/billing/profile`	Get the billing profile
GET	`/api/v1/tenants/{tenant}/billing/quote`	Price of a tariff
GET	`/api/v1/tenants/{tenant}/company`	Get the company data
PATCH	`/api/v1/tenants/{tenant}/company`	Update the company data
GET	`/api/v1/tenants/{tenant}/consent-settings`	Consent settings of every shop
PATCH	`/api/v1/tenants/{tenant}/consent-settings/{shop_id}`	Update the customer exception of a shop
GET	`/api/v1/tenants/{tenant}/grid-tags`	Labels used in a grid
GET	`/api/v1/tenants/{tenant}/labels`	List labels
POST	`/api/v1/tenants/{tenant}/labels`	Create a label
PATCH	`/api/v1/tenants/{tenant}/labels/{label_id}`	Update a label
DELETE	`/api/v1/tenants/{tenant}/labels/{label_id}`	Delete a label
POST	`/api/v1/tenants/{tenant}/labels/{label_id}/assign`	Assign a label to objects
POST	`/api/v1/tenants/{tenant}/maintenance/phone-landline-mobile`	Maintenance: move landline-stored mobile numbers to mobile (dry run unless apply)
POST	`/api/v1/tenants/{tenant}/maintenance/se-backfill-contacts`	Maintenance: fill empty contact fields from a SmartEmailing backup (dry run unless apply)
POST	`/api/v1/tenants/{tenant}/maintenance/shop-enrich`	Maintenance: fill empty contact fields from the e-shop feeds (dry run unless apply)
POST	`/api/v1/tenants/{tenant}/maintenance/shop-lists`	Maintenance: rebuild the e-shop lists (dry run unless apply)
GET	`/api/v1/tenants/{tenant}/notifications`	List notifications
POST	`/api/v1/tenants/{tenant}/notifications/delete`	Delete notifications
POST	`/api/v1/tenants/{tenant}/notifications/read`	Mark notifications as read
POST	`/api/v1/tenants/{tenant}/notifications/unread`	Mark notifications as unread
GET	`/api/v1/tenants/{tenant}/onboarding`	State of the onboarding wizard
PATCH	`/api/v1/tenants/{tenant}/onboarding`	Save the onboarding wizard
GET	`/api/v1/tenants/{tenant}/rfm`	State of the RFM analysis
POST	`/api/v1/tenants/{tenant}/rfm/enable-request`	Ask to enable the RFM analysis
GET	`/api/v1/tenants/{tenant}/running-actions`	Running background actions (imports, exports ...)
GET	`/api/v1/tenants/{tenant}/shop-enrich`	Whether order feed imports fill empty contact fields
PUT	`/api/v1/tenants/{tenant}/shop-enrich`	Turn the ongoing contact data enrichment on or off
GET	`/api/v1/tenants/{tenant}/shop-settings`	Sending company data of every shop
PATCH	`/api/v1/tenants/{tenant}/shop-settings/{shop_id}`	Update the sending company data of a shop
GET	`/api/v1/tenants/{tenant}/shops`	List shops (e-shops) of the company
POST	`/api/v1/tenants/{tenant}/shops`	Create a shop
GET	`/api/v1/tenants/{tenant}/shops/{shop_id}`	Get a shop
PATCH	`/api/v1/tenants/{tenant}/shops/{shop_id}`	Update a shop
GET	`/api/v1/tenants/{tenant}/shops/{shop_id}/brand`	Get the brand settings of a shop
PUT	`/api/v1/tenants/{tenant}/shops/{shop_id}/brand`	Replace the brand settings of a shop
PUT	`/api/v1/tenants/{tenant}/shops/{shop_id}/contact-language`	Set the default language of new contacts of a shop
POST	`/api/v1/tenants/{tenant}/shops/{shop_id}/disable`	Switch a shop off
POST	`/api/v1/tenants/{tenant}/shops/{shop_id}/enable`	Switch a shop on
GET	`/api/v1/tenants/{tenant}/site-script`	Every shop's one script line and connection state
PATCH	`/api/v1/tenants/{tenant}/site-script/{shop_id}`	Switch the checkout newsletter box of a shop
POST	`/api/v1/tenants/{tenant}/site-script/{shop_id}/check`	Test whether the script is on the shop's homepage
GET	`/api/v1/tenants/{tenant}/smartemailing`	State of the SmartEmailing migration
GET	`/api/v1/tenants/{tenant}/smartemailing/migrations/{migration_id}`	Get one SmartEmailing migration run
GET	`/api/v1/tenants/{tenant}/web-tracking`	Web tracking state of every shop
GET	`/api/v1/tenants/{tenant}/web-tracking/events`	List web tracking events
PATCH	`/api/v1/tenants/{tenant}/web-tracking/{shop_id}`	Switch web tracking of a shop

Public price list (no authentication)

GET /api/v1/public/price-list

Bez prihlásenia.

The active tiers and the settings of the calculator (public, as SmartEmailing's price list on its web).

Odpovede

200 OK: application/json PriceList

List account webhooks and their events

GET /api/v1/tenants/{tenant}/account-webhooks

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

{items, events, silentEvents, limit}: the company's account webhooks (oldest first), the events a webhook can listen to (SmartEmailing's 11) and those accepted for compatibility that never fire yet.

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 AccountWebhooks

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.

Create an account webhook

POST /api/v1/tenants/{tenant}/account-webhooks

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

{url, event, basicAuth?: {login, password}} -> 201 the webhook. Only what happens after the registration is sent. 400 validation url | event | basicAuth, 409 conflict url (the same address and event) | limit.

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: event, url.

Pole	Typ	Povinné	Popis
`url`	string	nie
`event`	one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	nie
`active`	boolean	nie
`basicAuth`	object or null	nie	null removes the credentials; password '' keeps the stored password (edit only).

Odpovede

201 Created: application/json AccountWebhook

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.

Edit, switch off or on an account webhook

PATCH /api/v1/tenants/{tenant}/account-webhooks/{webhook_id}

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

{url?, event?, active?, basicAuth?}: basicAuth null removes the credentials, {login, password: ''} keeps the password. A changed event starts at the newest item; switching on again clears the errors.

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.
`webhook_id`	path	string	áno	Id of the webhook (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`url`	string	nie
`event`	one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	nie
`active`	boolean	nie
`basicAuth`	object or null	nie	null removes the credentials; password '' keeps the stored password (edit only).

Odpovede

200 OK: application/json AccountWebhook

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 an account webhook

DELETE /api/v1/tenants/{tenant}/account-webhooks/{webhook_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.
`webhook_id`	path	string	áno	Id of the webhook (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.

Send a test call of an account webhook now

POST /api/v1/tenants/{tenant}/account-webhooks/{webhook_id}/test

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

Sends one test call now (a fictional contact test@example.com, "test": true, header X-Postarna-Test: 1): {ok, status, ms, error} with error scheme | dns | address | deadline | network | status. Moves nothing.

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.
`webhook_id`	path	string	áno	Id of the webhook (string of digits).

Odpovede

200 OK: application/json AccountWebhookTest

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.

Tariff, usage and balance

GET /api/v1/tenants/{tenant}/billing

Oprávnenie: modul billing, ú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 BillingOverview

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.

What cancelling the tariff would mean

GET /api/v1/tenants/{tenant}/billing/cancel

Oprávnenie: modul billing, ú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 CancelInfo

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.

List invoices

GET /api/v1/tenants/{tenant}/billing/invoices

Oprávnenie: modul billing, ú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.
`from`	query	string	nie	Start of the period (YYYY-MM-DD local day, or ISO time where noted).
`page`	query	integer	nie	Page number, from 1. default `1`, min 1
`pageSize`	query	integer	nie	Items per page, 1 to 100. default `25`, min 1, max 100
`q`	query	string	nie	Search text (case and diacritics insensitive). max 200 chars
`sort`	query	string	nie	Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id).
`status`	query	string	nie	Status filter.
`to`	query	string	nie	End of the period (YYYY-MM-DD local day, or ISO time where noted).
`type`	query	string	nie

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	currency, q, sort, status, type
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.

Download an invoice (PDF)

GET /api/v1/tenants/{tenant}/billing/invoices/{invoice_id}/pdf

Oprávnenie: modul billing, ú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.
`invoice_id`	path	string	áno	Id of the invoice (string of digits).

Odpovede

200 OK: application/pdf string (binary)

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.

QR payment code of an invoice (SVG)

GET /api/v1/tenants/{tenant}/billing/invoices/{invoice_id}/qr.svg

Oprávnenie: modul billing, ú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.
`invoice_id`	path	string	áno	Id of the invoice (string of digits).

Odpovede

200 OK: image/svg+xml string

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.

List payments

GET /api/v1/tenants/{tenant}/billing/payments

Oprávnenie: modul billing, ú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.
`page`	query	integer	nie	Page number, from 1. default `1`, min 1
`pageSize`	query	integer	nie	Items per page, 1 to 100. default `25`, min 1, max 100

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.
429		429 rate_limited: wait Retry-After seconds.

Get the billing profile

GET /api/v1/tenants/{tenant}/billing/profile

Oprávnenie: modul billing, ú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 BillingProfile

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.

Price of a tariff

GET /api/v1/tenants/{tenant}/billing/quote

Oprávnenie: modul billing, ú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.
`currency`	query	string	nie
`period`	query	string	nie
`tierId`	query	string	nie

Odpovede

200 OK: application/json BillingQuote

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.

Get the company data

GET /api/v1/tenants/{tenant}/company

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

The company holding the account: legal name, IČO, DIČ / IČ DPH (settings Firma).

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 AccountCompany

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.

Update the company data

PATCH /api/v1/tenants/{tenant}/company

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)

Pole	Typ	Povinné
`name`	string	nie
`companyId`	string	nie
`vatId`	string	nie

Odpovede

200 OK: application/json AccountCompany

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.

GET /api/v1/tenants/{tenant}/consent-settings

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

Customer exception (soft opt-in) months per shop.

The customer exception (soft opt-in) of every e-shop: a Slovak shop follows the law's own 12 months unless the tenant sets its own number for it (months); any other shop is off unless the tenant turns it on.

Poznámky kontraktu (cs): Zákaznická výjimka (soft opt-in) každého e-shopu: kolik měsíců po poslední dokončené objednávce kontaktu může e-shop ještě posílat obchodní sdělení bez jiného právního důvodu (modul settings: čtení GET, plný přístup PATCH). { "items": [ { "shopId": "12", "code": "sk", "language": "sk", "months": 12, "isDefault": true } ] }. months je účinná hodnota (null = vypnuto); isDefault true = platí zákonná výchozí hodnota e-shopu (slovenský e-shop 12 měsíců podle zákona č. 452/2021 Z. z. § 116 odst. 16, jiný e-shop vypnuto), false = tenant si nastavil vlastní počet (i výslovnou nulu). PATCH tělo { "months": 6 } (celé číslo 0 až 120, 0 = výslovně vypnuto) nebo { "months": null } (vrátí e-shopu jeho zákonnou výchozí hodnotu); jiná hodnota nebo neznámý e-shop = 400 validation s months, e-shop jiného tenanta 404.

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.

PATCH /api/v1/tenants/{tenant}/consent-settings/{shop_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full · Nástroj MCP: update_consent_settings

Sets the customer exception months of a shop (0 to 120, 0 = off, null = legal default).

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`months`	number or null	áno

Odpovede

200 OK: application/json ConsentSettings

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	months
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.

Labels used in a grid

GET /api/v1/tenants/{tenant}/grid-tags

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

Labels used in one grid (?grid=lists|segments|campaigns|automations), for the Štítky filter.

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.
`grid`	query	string	nie

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	grid
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 labels

GET /api/v1/tenants/{tenant}/labels

Oprávnenie: modul content, ú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.

Create a label

POST /api/v1/tenants/{tenant}/labels

Oprávnenie: modul content, ú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: color, name.

Pole	Typ	Povinné	Popis
`name`	string	áno
`color`	string	áno

Odpovede

201 Created: application/json Label

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 label

PATCH /api/v1/tenants/{tenant}/labels/{label_id}

Oprávnenie: modul content, ú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.
`label_id`	path	string	áno	Id of the label (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`name`	string	nie
`color`	string	nie

Odpovede

200 OK: application/json Label

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 label

DELETE /api/v1/tenants/{tenant}/labels/{label_id}

Oprávnenie: modul content, ú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.
`label_id`	path	string	áno	Id of the label (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.

Assign a label to objects

POST /api/v1/tenants/{tenant}/labels/{label_id}/assign

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

{lists?, segments?, campaigns?, automations?: [ids]} get the label (each kind needs full rights in its module).

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.
`label_id`	path	string	áno	Id of the label (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné
`lists`	array of string	nie
`segments`	array of string	nie
`campaigns`	array of string	nie
`automations`	array of string	nie

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.

Maintenance: move landline-stored mobile numbers to mobile (dry run unless apply)

POST /api/v1/tenants/{tenant}/maintenance/phone-landline-mobile

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

Owner, 13. 10. 2026: contacts whose phone (landline, "Pevná linka") in fact holds a mobile number (core/ phone.py classify_contact_field, from before that module existed) move it into mobile, only while mobile is still empty and nobody edited phone or mobile by hand; a true landline stays. Body {apply}, a dry run by default. 200 {checked, moved, keptLandline, keptEdited, applied}.

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)

Pole	Typ	Povinné	Popis
`apply`	any	nie

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	apply
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.

Maintenance: fill empty contact fields from a SmartEmailing backup (dry run unless apply)

POST /api/v1/tenants/{tenant}/maintenance/se-backfill-contacts

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

MG-01, AN-01 (core/se_backfill.run_records): body {contacts: [{email, column: value}] (records_to_json, a part of the export is fine), audienceFields: false, shopCustomers: false, apply}. Fills only empty fields; apply also recomputes the engagement grades. A large backfill goes in parts with reach: false and recompute: false (both default true) on all but the last part, so each call stays far under the 60 s request limit. 200 {counts per field ..., automations, applied}.

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)

Pole	Typ	Povinné	Popis
`apply`	any	nie
`contacts`	any	áno

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	apply, contacts
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.

Maintenance: fill empty contact fields from the e-shop feeds (dry run unless apply)

POST /api/v1/tenants/{tenant}/maintenance/shop-enrich

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

Contact data from the e-shop feeds (core/shop_enrich.run): body {apply}. Fills only empty fields from the customer accounts, the delivery data and the shop's language, derives gender, name day and salutations; apply also turns on the ongoing enrichment of the feed imports (phones and billing addresses come with the next whole order export). 200 {contacts, matched, contactsChanged, fill, language, derived, keptEdited, automationReach: [{id, name, nameDay, before, after, new, newPerMonth, newNext30Days}] (mailable contacts that may enter each active repeat automation before and after), ongoingBefore, ongoing, applied}.

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)

Pole	Typ	Povinné	Popis
`apply`	boolean	áno

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	apply, reach
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.

Maintenance: rebuild the e-shop lists (dry run unless apply)

POST /api/v1/tenants/{tenant}/maintenance/shop-lists

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

SZ-09, KK-09 (core/shop_lists.sync): body {seBackup: {lists: {se id: name}, members: {se id: [[address, state]]}} (optional), apply}. 200 {counts, lists: [{name, kind, action, members}], automations: active scenarios reading what changes, applied}.

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)

Pole	Typ	Povinné	Popis
`apply`	any	nie
`seBackup`	any	nie

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	apply
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 notifications

GET /api/v1/tenants/{tenant}/notifications

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

Notifications of the account (import finished, campaign sent or paused, automation paused...), newest first, with the unread count.

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 NotificationList

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.

Delete notifications

POST /api/v1/tenants/{tenant}/notifications/delete

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

{ids: [...]} removes those notifications, {all: true} every notification of the tenant (SE "Smazat vše").

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)

object

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	ids
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.

Mark notifications as read

POST /api/v1/tenants/{tenant}/notifications/read

Oprávnenie: modul null, ú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.

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

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

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	ids
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.

Mark notifications as unread

POST /api/v1/tenants/{tenant}/notifications/unread

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

SE "Označit jako nepřečtené": {ids: [...]}.

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: ids.

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

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	ids
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.

State of the onboarding wizard

GET /api/v1/tenants/{tenant}/onboarding

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

The onboarding wizard's state (core/onboarding.py).

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 OnboardingState

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.

Save the onboarding wizard

PATCH /api/v1/tenants/{tenant}/onboarding

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)

Pole	Typ	Povinné
`step`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`shopId`	string	nie
`skip`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`unskip`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`complete`	boolean	nie
`dismiss`	boolean	nie

Odpovede

200 OK: application/json OnboardingState

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.

State of the RFM analysis

GET /api/v1/tenants/{tenant}/rfm

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

SE GET rfm-analysis/model: Poštárna has no RFM model yet; whether the tenant asked for it.

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 RfmState

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.

Ask to enable the RFM analysis

POST /api/v1/tenants/{tenant}/rfm/enable-request

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

SE "Zapnout RFM analýzu": records the request (once), switches nothing 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.

Telo požiadavky (application/json)

object

Odpovede

200 OK: application/json RfmState

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.

Running background actions (imports, exports ...)

GET /api/v1/tenants/{tenant}/running-actions

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

SE "Probíhající akce": background work of the tenant that runs or waits to run (core/jobs.running_actions).

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.

Whether order feed imports fill empty contact fields

GET /api/v1/tenants/{tenant}/shop-enrich

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

{ongoing}: whether the order feed imports fill empty contact fields as they come (core/shop_enrich.SETTING; off until a member runs the enrichment or turns it on). Nastavení › E-shopy, Údaje kontaktů z e-shopu.

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.

Turn the ongoing contact data enrichment on or off

PUT /api/v1/tenants/{tenant}/shop-enrich

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

Body {ongoing: bool}: turns the ongoing enrichment of the order feed imports on or off (audited). Nothing is filled now; the one-time fill is POST /maintenance/shop-enrich. 200 {ongoing}.

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: ongoing.

Pole	Typ	Povinné	Popis
`ongoing`	boolean	áno

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	ongoing
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 company data of every shop

GET /api/v1/tenants/{tenant}/shop-settings

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

Sending company of each shop (name, address, IČO).

The sender company of every e-shop: name, IČO and registered office (footers of e-mails, pages and forms).

Poznámky kontraktu (cs): Odesílající firma každého e-shopu (Nastavení › Firma, modul settings: čtení GET, plný přístup PATCH). { "items": [ { "shopId": "11", "code": "cz", "displayName": "Example CZ", "language": "cs", "companyName": "Example s.r.o.", "companyId": "12345678", "companyAddress": "Ukázková 1, 110 00 Praha 1" } ] }. Patička každé kampaně a automatizace e-mail označí jako obchodní sdělení firmy a jejího webu a na druhém řádku uvede firmu se sídlem (companyAddress) a IČO (companyId), jen když jsou vyplněné (občanský zákoník § 435); stejné údaje mají patičky veřejných stránek a formulářů. PATCH přijme kterákoli z polí companyName (povinný, nejvýš 200 znaků), companyId (písmena a číslice, nejvýš 20, mezery se vynechají), companyAddress (nejvýš 300 znaků); mezery se sloučí, znaky { } < > a konce řádků = 400 validation s názvem pole, neznámé pole taky. Vrací změněnou položku; e-shop jiného tenanta 404.

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.

Update the sending company data of a shop

PATCH /api/v1/tenants/{tenant}/shop-settings/{shop_id}

Oprávnenie: modul settings, úroveň full; kľúč s prístupom full · Nástroj MCP: update_shop_settings

Changes the sending company of a shop.

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné
`companyId`	string	nie
`companyName`	string	nie
`companyAddress`	string	nie

Odpovede

200 OK: application/json ShopSettings

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.

List shops (e-shops) of the company

GET /api/v1/tenants/{tenant}/shops

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

Shops (e-shops) of the account with id, code, domain, currency, language.

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.

Create a shop

POST /api/v1/tenants/{tenant}/shops

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)

Pole	Typ	Povinné
`code`	string	áno
`displayName`	string	áno
`domain`	string	áno
`webDisplay`	string	nie
`language`	Lang	áno
`currency`	Currency	áno
`platform`	one of: `shoptet`, `woocommerce`, `prestashop`, `upgates`, `custom`	nie
`senderName`	string	nie
`senderEmail`	string	nie
`linkDomain`	string	nie
`companyName`	string	áno
`companyId`	string	nie
`companyAddress`	string	nie

Odpovede

201 Created: application/json ShopDetail

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.

Get a shop

GET /api/v1/tenants/{tenant}/shops/{shop_id}

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Odpovede

200 OK: application/json ShopDetail

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.

Update a shop

PATCH /api/v1/tenants/{tenant}/shops/{shop_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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné
`companyId`	string	nie
`companyName`	string	nie
`currency`	one of: `CZK`, `EUR`	nie
`companyAddress`	string	nie
`displayName`	string	nie
`domain`	string	nie
`webDisplay`	string	nie
`language`	one of: `cs`, `sk`	nie
`platform`	one of: `shoptet`, `woocommerce`, `prestashop`, `upgates`, `custom`	nie
`senderName`	string	nie
`senderEmail`	string	nie
`linkDomain`	string	nie

Odpovede

200 OK: application/json ShopDetail

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.

Get the brand settings of a shop

GET /api/v1/tenants/{tenant}/shops/{shop_id}/brand

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

{logoUrl, logoLink, logoWidth, primaryColor, secondaryColor, textColor, backgroundColor, fontFamily, headingFontFamily}: '' (logoWidth null) when unset; logoLink defaults to https:// and the shop's web address (web_display, else its domain) when unset.

Poznámky kontraktu (cs): Grafická identita e-shopu (SE „Grafická identita“); blok Logo v Magic editoru se z ní předvyplní. GET (modul content, čtení) → { "logoUrl", "logoLink", "logoWidth", "primaryColor", "secondaryColor", "textColor", "backgroundColor", "fontFamily", "headingFontFamily" }, nenastavené = '' (logoWidth null); logoLink bez hodnoty = https:// a webová adresa e-shopu (webDisplay, jinak doména). PUT (modul settings, plný přístup) s libovolnou částí polí: chybějící pole zůstane, '' (u logoWidth null) ho smaže. logoUrl, logoLink = '' nebo adresa https; barvy '' nebo #rrggbb (ukládají se malými písmeny); logoWidth null nebo celé číslo 20 až 800; písma '' nebo text do 100 znaků bez < > { } ; ". Neznámé pole nebo špatná hodnota 400 validation s názvem pole, neznámý e-shop 404. Odpověď jako GET. Ukládá se do shops.settings.brand; vzhled veřejných stránek (logo stránek) se nemění. Audit shop_brand_changed jen s názvy polí.

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Odpovede

200 OK: application/json ShopBrand

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.

Replace the brand settings of a shop

PUT /api/v1/tenants/{tenant}/shops/{shop_id}/brand

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

Body with any of the brand fields: a missing field is kept, '' (logoWidth null) clears it. logoUrl and logoLink '' or https, colours '' or #rrggbb (stored in lower case), logoWidth null or 20 to 800, fonts at most 100 characters without < > { } ; ". 400 validation <field>. Answers the brand like GET.

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`logoUrl`	string	nie
`logoLink`	string	nie	Where the logo leads; defaults to the shop's web.
`logoWidth`	number or null	nie
`primaryColor`	string	nie
`secondaryColor`	string	nie
`textColor`	string	nie
`backgroundColor`	string	nie
`fontFamily`	string	nie
`headingFontFamily`	string	nie

Odpovede

200 OK: application/json ShopBrand

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.

Set the default language of new contacts of a shop

PUT /api/v1/tenants/{tenant}/shops/{shop_id}/contact-language

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

SE's Nastavení aplikace › Výchozí jazyk kontaktu (UZ-02) of one shop: {language: cs | sk}; it applies to contacts added from now on by hand, over the API or by a sign-up (migration 0392). 400 validation language, 404 for another shop.

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Telo požiadavky (application/json)

Pole	Typ	Povinné	Popis
`language`	Lang	áno

Odpovede

200 OK: application/json Shop

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	language
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.

Switch a shop off

POST /api/v1/tenants/{tenant}/shops/{shop_id}/disable

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Odpovede

200 OK: application/json ShopDetail

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.

Switch a shop on

POST /api/v1/tenants/{tenant}/shops/{shop_id}/enable

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Odpovede

200 OK: application/json ShopDetail

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.

Every shop's one script line and connection state

GET /api/v1/tenants/{tenant}/site-script

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

The shops with their one line and connection state (module notes).

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.

Switch the checkout newsletter box of a shop

PATCH /api/v1/tenants/{tenant}/site-script/{shop_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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

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

Pole	Typ	Povinné	Popis
`checkoutConsent`	boolean	áno

Odpovede

200 OK: application/json SiteScriptShop

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	checkoutConsent
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.

Test whether the script is on the shop's homepage

POST /api/v1/tenants/{tenant}/site-script/{shop_id}/check

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

The Test button (module notes): {result, url, state, seenAt}.

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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

Odpovede

200 OK: application/json SiteScriptCheck

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 SmartEmailing migration

GET /api/v1/tenants/{tenant}/smartemailing

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

{connection (null before the first connect), migration (the latest run or null)}.

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 SeState

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 one SmartEmailing migration run

GET /api/v1/tenants/{tenant}/smartemailing/migrations/{migration_id}

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

Poznámky kontraktu (cs): SeMigration = { id, status (queued, running, finished, failed), phase ('', fields, contacts, suppressions, apply, purposes, templates, automations, report), progress { read, planned, applied, done }, plan, counts, report, failed, stopped, failure, createdAt, startedAt, finishedAt }. UI se ptá každé 2 s, dokud běh nedoběhne. failure = druh chyby neúspěšného běhu (stopped, credentials, unavailable, answer, dataKey, connection, error; jinak prázdné), nikdy technický text; ten zůstává v databázi a v logu workeru (bez adres a klíčů). stopped = běh se přerušil, protože se zastavil worker (jeho úloha už neběží); POST /migrations se stejným plánem ho obnoví (stejné id, hotové fáze se přeskočí, kontakty pokračují za poslední uloženou dávkou), jiný plán založí nový běh.

report (SeReport, jen počty, nikdy adresa): rows (contacts, blacklisted, hardbounced, unsubscribed (odhlášení ze seznamů), listUnsubscribes (odhlášení ze seznamů, které se nepřenášejí, u kontaktů v Poštárně), customFields, purposes, consents, templates, automations: { key, se, postarna, created?, skipped?, archived?, imagesFailed?, failed? }), lists ({ id, name, role, seConfirmed, seUnsubscribed, postarnaConfirmed, postarnaUnsubscribed }; u role skip je postarnaUnsubscribed počet kontaktů, u kterých si Poštárna odhlášení z toho seznamu pamatuje), skipped (not_in_mapped_lists, invalid_address), merged { duplicate_address } (záznamy SE se stejnou adresou sloučené do jednoho kontaktu), problems ([{ code, count, blocking }], kódy blacklistMissing, hardbounceMissing, unsubscribeMissing, listUnsubscribeMissing, suppressionMissing blokují; duplicatesMerged, invalidWithOptOut, listUnsubscribeNotInPostarna, erased jen informují), suppressionDiff { seOnly, postarnaOnly } a readyToSend (blacklist, tvrdé bounce i odhlášení SE jsou všechny v Poštárně, osoba vymazaná na žádost se počítá jako zablokovaná, žádný blokující problém).

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.
`migration_id`	path	string	áno	Id of the migration (string of digits).

Odpovede

200 OK: application/json SeMigration

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.

Web tracking state of every shop

GET /api/v1/tenants/{tenant}/web-tracking

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

Shops with the Používat switch, whether a scenario listens to their carts, and the script address.

Poznámky kontraktu (cs): SE Datové zdroje › Webtracking (migrace 0151). GET (modul settings) { "items": [ { "shopId", "code", "name", "domain", "enabled", "listening", "scriptUrl" } ] }: enabled = přepínač Používat (výchozí zapnuto), listening = v e-shopu běží scénář se spouštěčem Změna v košíku, scriptUrl = adresa cart.js pro řádek do patičky. PATCH (plný přístup settings) {enabled: bool} → 204; vypnutý e-shop košíky z webu neukládá (web_tracking.record_cart → off). events (modul contacts, jen čtení): události cart, visit, custom kontaktů tenanta od nejnovější (filtr type přijímá i identification, typ SE Identifikace; Poštárna ho zatím nezapisuje), type, q (e-mail), shopId, stránkování (max 100); položka { "id", "type", "data", "at", "shopId", "source", "contactId", "email" }.

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.

List web tracking events

GET /api/v1/tenants/{tenant}/web-tracking/events

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

SE grid Identifikováni: ?type=visit|identification|cart|custom, ?q= (e-mail), ?shopId=, paging.

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.
`page`	query	integer	nie	Page number, from 1. default `1`, min 1
`pageSize`	query	integer	nie	Items per page, 1 to 100. default `25`, min 1, max 100
`q`	query	string	nie	Search text (case and diacritics insensitive). max 200 chars
`shopId`	query	string	nie
`type`	query	string	nie

Odpovede

200 OK: application/json object

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	q, type
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.

Switch web tracking of a shop

PATCH /api/v1/tenants/{tenant}/web-tracking/{shop_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.
`shop_id`	path	string	áno	Id of the shop (string of digits).

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

Pole	Typ	Povinné	Popis
`enabled`	boolean	áno

Odpovede

204 No content

Chyby

Stav	Kód	Hodnoty `message`
400	`validation`	enabled
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.

Schémy

AccountCompany

The company holding the account (GET /tenants/{t}/company).

Pole	Typ	Povinné
`name`	string	áno
`companyId`	string	áno
`vatId`	string	áno

AccountWebhook

An account webhook (Nastavení › Datové zdroje › Webhooky; the same rows as API v3 /web-hooks).

Pole	Typ	Povinné	Popis
`id`	string	áno
`url`	string	áno
`event`	one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	áno
`active`	boolean	áno	false = switched off (by hand, or by itself after errorsLimit errors in a row).
`silent`	boolean	áno	Accepted for compatibility, never fires yet.
`timeoutS`	number	áno
`basicLogin`	string or null	áno	HTTP Basic user name; the password is never answered.
`lastResponseCode`	number or null	áno
`lastCallAt`	string or null	áno
`errorsInRow`	number	áno
`errorsLimit`	number	áno
`viaApi`	boolean	áno	Registered with an API key (API v3).
`createdAt`	string	áno

AccountWebhookInput

Pole	Typ	Povinné	Popis
`url`	string	nie
`event`	one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	nie
`active`	boolean	nie
`basicAuth`	object or null	nie	null removes the credentials; password '' keeps the stored password (edit only).

AccountWebhookTest

Pole	Typ	Povinné
`ok`	boolean	áno
`status`	number or null	áno
`ms`	number or null	áno
`error`	string	áno

AccountWebhooks

Pole	Typ	Povinné
`items`	array of AccountWebhook	áno
`events`	array of one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	áno
`silentEvents`	array of one of: `new_contact`, `updated_contact`, `unsubscribed_contact`, `email_delivery_started`, `delivery_status`, `sent_email`, `email_open`, `email_click`, `scoring_result_changed`, `engagement_level_changed`, `sms_delivery_status`	áno
`limit`	number	áno

AppNotification

Pole	Typ	Povinné	Popis
`id`	string	áno
`type`	NotificationType	áno
`params`	map of string or number	áno	Values for the placeholders of notifications.type.<type>; numbers are formatted by the UI.
`important`	boolean	áno
`read`	boolean	áno
`createdAt`	string	áno

BankDetails

Pole	Typ	Povinné	Popis
`account`	string	áno
`iban`	string	áno

BillingBlock

one of: `, free_limit, unpaid`

BillingCurrency

one of: CZK, EUR

BillingOverview

Pole	Typ	Povinné	Popis
`subscription`	Subscription	áno
`priceList`	PriceList	áno
`profile`	BillingProfile	áno
`bank`	object	áno	null = the platform has not set that account yet ("nenastaveno").
`cardPayment`	`soon`	áno
`support`	object	áno

BillingPeriod

one of: monthly, annual

BillingProfile

Pole	Typ	Povinné	Popis
`firstName`	string	áno
`lastName`	string	áno
`billingEmail`	string	áno
`phone`	string	áno
`isCompany`	boolean	áno
`country`	string	áno
`companyName`	string	áno
`companyId`	string	áno
`vatId`	string	áno
`vatPayer`	boolean	áno
`street`	string	áno
`city`	string	áno
`zip`	string	áno
`currency`	BillingCurrency	áno
`saved`	boolean	nie
`complete`	boolean	nie
`vatCheck`	VatCheck	nie	The VIES check of the VAT ID (server only; never sent back on save).

BillingQuote

Pole	Typ	Povinné	Popis
`tier`	PriceTier	áno
`currency`	BillingCurrency	áno
`period`	BillingPeriod	áno
`monthly`	string	áno
`net`	string	áno
`vatRate`	string	áno
`vat`	string	áno
`total`	string	áno
`reverseCharge`	boolean	áno
`annualSaving`	string	áno
`beforeDiscount`	string or null	áno
`upgradeNet`	string or null	áno
`change`	one of: `new`, `upgrade`, `downgrade`, `same`	áno	new = a new subscription (first invoice below), upgrade now, downgrade from the next period, same tier.
`contacts`	number	áno
`fits`	boolean	áno	The contacts fit the tier now (a downgrade is refused otherwise).
`firstStart`	string or null	áno
`firstEnd`	string or null	áno
`firstNet`	string or null	áno
`firstVat`	string or null	áno
`firstTotal`	string or null	áno

BillingSlice

A period and its net price.

Pole	Typ	Povinné
`on`	string	áno
`start`	string	áno
`end`	string	áno
`net`	string	áno

CancelInfo

Pole	Typ	Povinné	Popis
`blockers`	array of one of: `trial`, `unpaid`, `profile`, `not_active`, `already`	áno
`reasons`	array of CancelReason	áno

CancelReason

one of: not_needed, complex, missing_features, bugs, price, communication, other_tool, other

ConsentSettings

The customer exception (soft opt-in) of one e-shop (GET /tenants/{t}/consent-settings): how many months after a contact's last completed order the shop may still mail it without another consent basis. months null = off. isDefault true = the shop's own law default (12 months for a Slovak shop, off otherwise, SK zákon č. 452/2021 Z. z. § 116 odst. 16), not a choice the tenant made; false = the tenant's own number (including an explicit 0).

Pole	Typ	Povinné
`shopId`	string	áno
`code`	string	áno
`language`	Lang	áno
`months`	number or null	áno
`isDefault`	boolean	áno

Currency

one of: CZK, EUR

Error

Pole	Typ	Povinné	Popis
`error`	object	áno

json

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

Invoice

Pole	Typ	Povinné	Popis
`id`	string	áno
`number`	string	áno
`kind`	one of: `invoice`, `credit_note`	áno
`purpose`	one of: `upgrade`, `subscription`, `overage`, `manual`, `credit`	áno
`currency`	BillingCurrency	áno
`net`	string	áno
`vat`	string	áno
`total`	string	áno
`vatRate`	string	áno
`reverseCharge`	boolean	áno
`paidAmount`	string	áno
`state`	one of: `cancelled`, `issued`, `paid`	áno
`status`	InvoiceStatus	áno
`issueDate`	string	áno
`dueDate`	string	áno
`paidAt`	string or null	áno
`sentAt`	string or null	áno
`periodStart`	string	áno
`periodEnd`	string	áno
`days`	number	áno	Days after the due date (overdue) or until it (unpaid).
`creditFor`	string or null	áno
`reminders`	number	áno
`hasQr`	boolean	áno
`buyerName`	string	áno
`tenant`	object	nie

InvoiceStatus

one of: cancelled, unpaid, credit, paid, partial, overdue, due_today

Label

SE Štítky: a label with its RGBA colour (#rrggbbaa) and how many records carry it.

Pole	Typ	Povinné
`id`	string	áno
`name`	string	áno
`color`	string	áno
`used`	number	áno
`createdAt`	string	áno

LabelTargets

Pole	Typ	Povinné
`lists`	array of string	nie
`segments`	array of string	nie
`campaigns`	array of string	nie
`automations`	array of string	nie

Lang

one of: cs, sk

NotificationList

Pole	Typ	Povinné	Popis
`items`	array of AppNotification	áno
`unread`	number	áno

NotificationType

one of: import_finished, campaign_sent, domain_verified, bounce_warning, export_ready, automation_paused, list_contacts_added, list_unsubscribed, campaign_paused, automation_notice, se_sync_problem, import_waiting, purpose_assigned_list, engagement_computed, contacts_bulk_done, list_merged, list_deleted

OnboardingPatch

Pole	Typ	Povinné
`step`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`shopId`	string	nie
`skip`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`unskip`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	nie
`complete`	boolean	nie
`dismiss`	boolean	nie

OnboardingState

Pole	Typ	Povinné	Popis
`visible`	boolean	áno	Shown on the dashboard (not finished, not closed; a company without a row only while it has no contact).
`step`	one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	áno
`skipped`	array of one of: `domain`, `shop`, `script`, `feeds`, `contacts`, `done`	áno
`completedAt`	string or null	áno
`dismissedAt`	string or null	áno
`shop`	object or null	áno
`steps`	object	áno	Done from the data itself.
`feeds`	object	áno
`contacts`	number	áno
`progress`	number	áno	Steps of the first five that are done or skipped.
`total`	number	áno

OverageDay

One day over the tier: (price of the tier that fits - price of the tier) / days of the month.

Pole	Typ	Povinné
`day`	string	áno
`contacts`	number	áno
`over`	number	áno
`fromMax`	number	áno
`toMax`	number	áno
`amount`	string	áno

Payment

Pole	Typ	Povinné
`id`	string	áno
`invoiceId`	string	áno
`invoiceNumber`	string	áno
`amount`	string	áno
`currency`	BillingCurrency	áno
`paidOn`	string	áno
`method`	one of: `bank`, `card`, `credit_note`, `manual`	áno

PriceList

Pole	Typ	Povinné
`tiers`	array of PriceTier	áno
`annualDiscountPct`	string	áno
`vatRate`	string	áno
`trialDays`	number	áno
`freeContacts`	number	áno
`freeEmailsMonth`	number	áno
`fairUseSends`	number	áno
`currencies`	array of BillingCurrency	áno

PriceTier

Pole	Typ	Povinné	Popis
`id`	string	áno
`maxContacts`	number	áno
`monthly`	string or null	áno	Net a month in the subscription's currency; null = individual price.
`monthlyCzk`	string or null	áno
`monthlyEur`	string or null	nie
`free`	boolean	áno
`active`	boolean	áno

RfmState

RFM analysis (SE GET rfm-analysis/model): no model in Poštárna yet; whether the company asked for it.

Pole	Typ	Povinné
`enabled`	boolean	áno
`requested`	boolean	áno
`requestedAt`	string or null	áno

RunningAction

Pole	Typ	Povinné
`id`	string	áno
`kind`	one of: `import_run`, `import_doi`, `export_run`, `feed_refresh`, `order_feed_refresh`, `se_discover`, `se_sync_suppressions`, `engagement_recompute`, `contacts_bulk`, `list_merge`, `list_delete`	áno
`status`	one of: `queued`, `running`	áno
`since`	string	áno

SeConnection

Pole	Typ	Povinné	Popis
`login`	string	áno
`keyHint`	string	áno	First three characters of the key (the key itself is never returned).
`accountId`	string or null	áno
`verifiedAt`	string	áno
`lists`	map of SeListChoice	áno
`options`	object	áno
`syncEnabled`	boolean	áno	Hourly sync of the parallel run.
`syncChangedAt`	string or null	áno
`lastSyncAt`	string or null	áno
`lastSync`	map of string or number	áno
`syncStatus`	one of: `ok`, `failed`, `skipped`, `late`	nie	ok, skipped (a switch run was queued or running), failed (syncProblem says why) or late (no sync for 3 hours).
`syncProblem`	string	nie	credentials, unavailable, dataKey, error, migration_running or no_sync.
`syncProblemAt`	string or null	nie

SeListChoice

Pole	Typ	Povinné	Popis
`role`	one of: `optin`, `member`, `unsub`, `skip`	áno
`shop`	string	áno	Shop code (cz, sk).
`name`	string	áno

SeMigration

Pole	Typ	Povinné	Popis
`id`	string	áno
`status`	one of: `queued`, `running`, `finished`, `failed`	áno
`phase`	one of: `, contacts`,` purposes`,` templates`,` automations`,` fields`,` suppressions`,` apply`,` report`	áno
`progress`	object	áno
`plan`	object	áno
`counts`	map of number	áno
`report`	SeReport or null	áno
`failed`	boolean	áno
`stopped`	boolean	nie	The worker stopped before the run finished; starting it again resumes it.
`failure`	one of: `, unavailable`,` error`,` stopped`,` credentials`,` answer`,` dataKey`,` connection`	nie	The kind of a failed run (SE_RUN_FAILURES), '' otherwise; never the technical text.
`createdAt`	string	áno
`startedAt`	string or null	áno
`finishedAt`	string or null	áno

SeProblem

Pole	Typ	Povinné	Popis
`code`	one of: `blacklistMissing`, `hardbounceMissing`, `unsubscribeMissing`, `listUnsubscribeMissing`, `suppressionMissing`, `duplicatesMerged`, `invalidWithOptOut`, `listUnsubscribeNotInPostarna`, `erased`	áno
`count`	number	áno
`blocking`	boolean	áno	true = Poštárna must not send yet (readyToSend false).

SeReport

Pole	Typ	Povinné	Popis
`rows`	array of SeReportRow	áno
`lists`	array of object	áno
`skipped`	map of number	áno	Contacts not taken over and why (not_in_mapped_lists, invalid_address).
`mapping`	map of number	áno
`merged`	object	nie	SmartEmailing records merged into one contact because their addresses are the same.
`problems`	array of SeProblem	nie
`suppressionDiff`	object	áno
`readyToSend`	boolean	áno	Blacklist, hard bounces and unsubscribes of SmartEmailing are all in Poštárna: Poštárna may send.

SeReportRow

One line of the reconciliation: SmartEmailing against Poštárna (counts only).

Pole	Typ	Povinné
`key`	one of: `unsubscribed`, `blacklisted`, `contacts`, `purposes`, `templates`, `automations`, `hardbounced`, `listUnsubscribes`, `customFields`, `consents`	áno
`se`	number	áno
`postarna`	number	áno
`created`	number	nie
`skipped`	number	nie
`archived`	number	nie
`imagesFailed`	number	nie
`failed`	number	nie

SeState

Pole	Typ	Povinné	Popis
`connection`	SeConnection or null	áno
`migration`	SeMigration or null	áno

Shop

Pole	Typ	Povinné	Popis
`id`	string	áno
`code`	string	áno	cz, sk (ShopSettings.code)
`displayName`	string	áno
`domain`	string	áno
`currency`	Currency	áno
`language`	Lang	áno
`active`	boolean	nie	false = switched off in settings E-shopy (hidden from the switcher and pickers); absent = active.
`contactLanguage`	one of: `cs`, `sk`	nie	SE's Výchozí jazyk kontaktu (UZ-02): the language of the shop's new contacts that come without one; until chosen (contactLanguageSet false) Czech for a .cz and Slovak for a .sk domain.
`contactLanguageSet`	boolean	nie

ShopBrand

Brand identity of an e-shop (SmartEmailing "Grafická identita"): the Logo element and predefined sections use it.

Pole	Typ	Povinné	Popis
`logoUrl`	string	áno
`logoLink`	string	áno	Where the logo leads; defaults to the shop's web.
`logoWidth`	number or null	áno
`primaryColor`	string	áno
`secondaryColor`	string	áno
`textColor`	string	áno
`backgroundColor`	string	áno
`fontFamily`	string	áno
`headingFontFamily`	string	áno

ShopConnector

The connector of orders and customers as the tenant sees it; the platform sets it (its key is the platform's).

Pole	Typ	Povinné	Popis
`host`	string	áno
`intervalS`	number	áno	Seconds between automatic runs; 0 = only by hand.

ShopDetail

Pole	Typ	Povinné	Popis
`webDisplay`	string	áno
`platform`	one of: `shoptet`, `woocommerce`, `prestashop`, `upgates`, `custom`	áno
`senderName`	string	áno
`senderEmail`	string	áno
`linkDomain`	string	áno	Own domain of tracking and unsubscribe links; '' = the platform's.
`companyName`	string	áno
`companyId`	string	áno
`companyAddress`	string	áno
`active`	boolean	áno	false = switched off in settings E-shopy (hidden from the switcher and pickers); absent = active.
`disabledAt`	string or null	áno
`createdAt`	string	áno
`connector`	ShopConnector or null	áno
`usage`	ShopUsage	áno
`locked`	boolean	áno	Language and currency are fixed once the shop has contacts, orders, feeds or a sent campaign.
`id`	string	áno
`code`	string	áno	cz, sk (ShopSettings.code)
`displayName`	string	áno
`domain`	string	áno
`currency`	Currency	áno
`language`	Lang	áno
`contactLanguage`	one of: `cs`, `sk`	nie	SE's Výchozí jazyk kontaktu (UZ-02): the language of the shop's new contacts that come without one; until chosen (contactLanguageSet false) Czech for a .cz and Slovak for a .sk domain.
`contactLanguageSet`	boolean	nie

ShopInput

POST /tenants/{t}/shops (code, displayName, domain, language, currency, companyName required) and PATCH (code fixed).

Pole	Typ	Povinné
`code`	string	áno
`displayName`	string	áno
`domain`	string	áno
`webDisplay`	string	nie
`language`	Lang	áno
`currency`	Currency	áno
`platform`	one of: `shoptet`, `woocommerce`, `prestashop`, `upgates`, `custom`	nie
`senderName`	string	nie
`senderEmail`	string	nie
`linkDomain`	string	nie
`companyName`	string	áno
`companyId`	string	nie
`companyAddress`	string	nie

ShopSettings

The sender company of one e-shop (settings Firma, GET /tenants/{t}/shop-settings): every campaign and automation e-mail names it in the standard footer, the public pages and forms in theirs. companyId (IČO) and companyAddress (registered office) are shown only when filled ('' = not filled).

Pole	Typ	Povinné
`shopId`	string	áno
`code`	string	áno
`displayName`	string	áno
`language`	Lang	áno
`companyName`	string	áno
`companyId`	string	áno
`companyAddress`	string	áno

ShopUsage

What a shop has (GET /tenants/{t}/shops/{id}).

Pole	Typ	Povinné
`contacts`	number	áno
`lists`	number	áno
`segments`	number	áno
`campaigns`	number	áno
`automationsActive`	number	áno
`feeds`	number	áno
`orders`	number	áno

SiteScriptCheck

The Test button (POST /tenants/{t}/site-script/{shop}/check): found = the line is on the homepage.

Pole	Typ	Povinné
`result`	one of: `found`, `not_found`, `unreachable`	áno
`url`	string or null	áno
`state`	one of: `live`, `quiet`, `waiting`	áno
`seenAt`	string or null	áno

SiteScriptShop

Pole	Typ	Povinné	Popis
`shopId`	string	áno
`code`	string	áno
`name`	string	áno
`domain`	string	áno
`webDisplay`	string	áno
`platform`	one of: `shoptet`, `woocommerce`, `prestashop`, `upgates`, `custom`	áno
`scriptUrl`	string	áno	The postarna.js address of the one line.
`snippet`	string	áno	The whole line for the shop's footer.
`state`	one of: `live`, `quiet`, `waiting`	áno	live = the script reported within 3 days, quiet = earlier, waiting = never.
`seenAt`	string or null	áno
`seenHost`	string	áno
`checkoutConsent`	boolean	áno	The script also reads the newsletter box of the checkout and the registration.
`popups`	number	áno	Active pop-up and slide-in forms the script shows; active classic forms it can place.
`embeds`	number	áno
`signups`	object	áno	Checkout newsletter boxes of the last 30 days by state.

Subscription

Pole	Typ	Povinné	Popis
`state`	SubscriptionState	áno
`inTrial`	boolean	áno
`trialEndsAt`	string or null	áno
`trialDaysLeft`	number	áno
`period`	BillingPeriod	áno
`currency`	BillingCurrency	áno
`tier`	PriceTier or null	áno
`manual`	boolean	áno
`customMonthly`	string or null	áno
`monthly`	string or null	áno
`periodNet`	string or null	áno
`annualMonthly`	string or null	áno
`annualSaving`	string or null	áno
`annualDiscountPct`	string	áno
`vatRate`	string	áno
`contacts`	number	áno
`limit`	number or null	áno
`overBy`	number	áno
`contactsChange30d`	number or null	áno
`sentMonth`	number	áno
`free`	boolean	áno
`freeEmailsMonth`	number or null	áno
`fairUseLimit`	number	áno
`fairUseSends`	number	áno
`nextInvoiceOn`	string or null	áno	Day the next invoice is issued: at once for the first one, the 2nd of the month for a renewal.
`nextPeriodOn`	string or null	áno	First day of the next (or the waiting) period: a planned lower tier and the renewal apply from it.
`daysToInvoice`	number or null	áno
`periodStart`	string or null	áno
`periodEnd`	string or null	áno
`cancelAt`	string or null	áno
`billingBlock`	BillingBlock	áno
`billingExempt`	boolean	áno
`sendingState`	string	áno
`paymentMethod`	one of: `bank`, `card`	áno
`overageTotal`	string or null	áno
`overageDays`	number	áno
`currentSpend`	string or null	áno
`unpaidInvoices`	number	áno
`overdueInvoices`	number	áno
`ordered`	boolean	áno	A paid tier is ordered (in the trial: it starts when the trial ends).
`dueDays`	number	áno
`firstInvoice`	BillingSlice or null	áno	A tier ordered in the trial: its first invoice on the day the trial ends, for the rest of that month (pro rata).
`nextTier`	PriceTier or null	áno	Snížit tarif: the lower tier planned from the next period (null = none).
`nextBilling`	object or null	áno	The next invoice of a running subscription: the tier (the planned lower one) and the overage of a monthly one.
`overageFrom`	string or null	áno	First day of the overage not billed yet (null outside a paid period).
`overage`	array of OverageDay	áno	Days over the tier since overageFrom (SE Příloha k faktuře), billed with the next invoice.

SubscriptionState

one of: trial, active, past_due, suspended, cancelled, expired

VatCheck

Pole	Typ	Povinné	Popis
`required`	boolean	áno	An EU company outside CZ that says it is a VAT payer: only then is the VAT ID checked.
`state`	VatCheckState	áno
`vatId`	string	áno
`checkedAt`	string or null	áno
`name`	string	áno	Name and address as VIES returned them; requestIdentifier = the consultation number (evidence).
`address`	string	áno
`requestIdentifier`	string	áno
`error`	string	áno
`lastValidAt`	string or null	áno
`fallbackUntil`	string or null	áno	Until when an unavailable VIES still allows reverse charge (last valid check + 30 days).
`reverseCharge`	boolean	áno

VatCheckState

one of: not_needed, unchecked, valid, invalid, unavailable

WebTrackingEvent

One row of the grid Identifikováni (a tracked event of a contact).

Pole	Typ	Povinné
`id`	string	áno
`type`	one of: `custom`, `visit`, `identification`, `cart`	áno
`data`	map of any	áno
`at`	string	áno
`shopId`	string or null	áno
`source`	string	áno
`contactId`	string	áno
`email`	string	áno

WebTrackingShop

SE Datové zdroje › Webtracking: a shop's Používat switch, whether a scenario listens to its carts, the script.

Pole	Typ	Povinné	Popis
`shopId`	string	áno
`code`	string	áno
`name`	string	áno
`domain`	string	áno
`enabled`	boolean	áno
`listening`	boolean	áno
`scriptUrl`	string	áno	The cart.js address for the one line in the shop's footer.

Account and settings

Operácie#

Public price list (no authentication)#

List account webhooks and their events#

Create an account webhook#

Edit, switch off or on an account webhook#

Delete an account webhook#

Send a test call of an account webhook now#

Tariff, usage and balance#

What cancelling the tariff would mean#

List invoices#

Download an invoice (PDF)#

QR payment code of an invoice (SVG)#

List payments#

Get the billing profile#

Price of a tariff#

Get the company data#

Update the company data#

Consent settings of every shop#

Update the customer exception of a shop#

Labels used in a grid#

List labels#

Create a label#

Update a label#

Delete a label#

Assign a label to objects#

Maintenance: move landline-stored mobile numbers to mobile (dry run unless apply)#

Maintenance: fill empty contact fields from a SmartEmailing backup (dry run unless apply)#

Maintenance: fill empty contact fields from the e-shop feeds (dry run unless apply)#

Maintenance: rebuild the e-shop lists (dry run unless apply)#

List notifications#

Delete notifications#

Mark notifications as read#

Mark notifications as unread#

State of the onboarding wizard#

Save the onboarding wizard#

State of the RFM analysis#

Ask to enable the RFM analysis#

Running background actions (imports, exports ...)#

Whether order feed imports fill empty contact fields#

Turn the ongoing contact data enrichment on or off#

Sending company data of every shop#

Update the sending company data of a shop#

List shops (e-shops) of the company#

Create a shop#

Get a shop#

Update a shop#

Get the brand settings of a shop#

Replace the brand settings of a shop#

Set the default language of new contacts of a shop#

Switch a shop off#

Switch a shop on#

Every shop's one script line and connection state#

Switch the checkout newsletter box of a shop#

Test whether the script is on the shop's homepage#

State of the SmartEmailing migration#

Get one SmartEmailing migration run#

Web tracking state of every shop#

List web tracking events#

Switch web tracking of a shop#

Schémy#

AccountCompany#

AccountWebhook#

AccountWebhookInput#

AccountWebhookTest#

AccountWebhooks#

AppNotification#

BankDetails#

BillingBlock#

BillingCurrency#

BillingOverview#

BillingPeriod#

BillingProfile#

BillingQuote#

BillingSlice#

CancelInfo#

CancelReason#

ConsentSettings#

Currency#

Error#

Operácie

Public price list (no authentication)

List account webhooks and their events

Create an account webhook

Edit, switch off or on an account webhook

Delete an account webhook

Send a test call of an account webhook now

Tariff, usage and balance

What cancelling the tariff would mean

List invoices

Download an invoice (PDF)

QR payment code of an invoice (SVG)

List payments

Get the billing profile

Price of a tariff

Get the company data

Update the company data

Consent settings of every shop

Update the customer exception of a shop

Labels used in a grid

List labels

Create a label

Update a label

Delete a label

Assign a label to objects

Maintenance: move landline-stored mobile numbers to mobile (dry run unless apply)

Maintenance: fill empty contact fields from a SmartEmailing backup (dry run unless apply)

Maintenance: fill empty contact fields from the e-shop feeds (dry run unless apply)

Maintenance: rebuild the e-shop lists (dry run unless apply)

List notifications

Delete notifications

Mark notifications as read

Mark notifications as unread

State of the onboarding wizard

Save the onboarding wizard

State of the RFM analysis

Ask to enable the RFM analysis

Running background actions (imports, exports ...)

Whether order feed imports fill empty contact fields

Turn the ongoing contact data enrichment on or off

Sending company data of every shop

Update the sending company data of a shop

List shops (e-shops) of the company

Create a shop

Get a shop

Update a shop

Get the brand settings of a shop

Replace the brand settings of a shop

Set the default language of new contacts of a shop

Switch a shop off

Switch a shop on

Every shop's one script line and connection state

Switch the checkout newsletter box of a shop

Test whether the script is on the shop's homepage

State of the SmartEmailing migration

Get one SmartEmailing migration run

Web tracking state of every shop

List web tracking events

Switch web tracking of a shop

Schémy

AccountCompany

AccountWebhook

AccountWebhookInput

AccountWebhookTest

AccountWebhooks

AppNotification

BankDetails

BillingBlock

BillingCurrency

BillingOverview

BillingPeriod

BillingProfile

BillingQuote

BillingSlice

CancelInfo

CancelReason

ConsentSettings

Currency

Error

Invoice