Lists
Contact lists with explicit membership (manual and form lists) and the lists bound to an e-shop (read only membership).
Technická reference je anglicky (stejně jako strojově čitelný dokument OpenAPI). Celou skupinu pro AI agenta načtete z /api/openapi.json?tag=Lists.
Přihlášení: Authorization: Bearer pst_... nebo HTTP Basic (e-mail člena firmy a API klíč).
Operace
| Metoda | Cesta | Popis |
|---|---|---|
| GET | /api/v1/tenants/{tenant}/lists | List contact lists |
| POST | /api/v1/tenants/{tenant}/lists | Create a list |
| POST | /api/v1/tenants/{tenant}/lists/merge | Merge lists into a new list (background) |
| POST | /api/v1/tenants/{tenant}/lists/tags | Change labels of lists |
| GET | /api/v1/tenants/{tenant}/lists/{list_id} | Get a list |
| PATCH | /api/v1/tenants/{tenant}/lists/{list_id} | Update a list |
| DELETE | /api/v1/tenants/{tenant}/lists/{list_id} | Delete a list (only the list, with its contacts, or keeping contacts in other lists) |
| POST | /api/v1/tenants/{tenant}/lists/{list_id}/autofill | Fill empty name day, gender and salutations of the members |
| POST | /api/v1/tenants/{tenant}/lists/{list_id}/copy | Copy a list with its members |
| GET | /api/v1/tenants/{tenant}/lists/{list_id}/members | List members of a list |
| POST | /api/v1/tenants/{tenant}/lists/{list_id}/members | Add contacts to a list |
| POST | /api/v1/tenants/{tenant}/lists/{list_id}/members/remove | Remove contacts from a list |
| POST | /api/v1/tenants/{tenant}/lists/{list_id}/members/unsubscribe | Unsubscribe contacts from a list |
List contact lists
GET /api/v1/tenants/{tenant}/lists
Oprávnění: modul contacts, úroveň read; klíč s přístupem read nebo full · Nástroj MCP: list_lists
Contact lists with member counts by bucket. shop = lists of the shop and of the whole company.
Filtry of the grid (routes_grid.py): ?tag= (repeatable, every label), ?idFrom=&idTo=, ?createdFrom=&createdTo= (calendar days), ?membersFrom=&membersTo= (members of any state except removed), ?activeFrom=&activeTo= (SE's Počet aktivních kontaktů), ?publicName= (part of the public name).
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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 | ne | Page number, from 1. default 1, min 1 |
pageSize | query | integer | ne | Items per page, 1 to 100. default 25, min 1, max 100 |
publicName | query | string | ne | |
q | query | string | ne | Search text. max 200 chars |
shop | query | string | ne | Shop id filter. |
sort | query | string | ne | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
tag | query | string | ne | Tag filter. |
Odpovědi
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | publicName, q, sort, tag |
| 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 list
POST /api/v1/tenants/{tenant}/lists
Oprávnění: modul contacts, úroveň full; klíč s přístupem full · Nástroj MCP: create_list
Creates a manual list.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
Tělo požadavku (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | ano | |
publicName | string | ano | |
shopId | string or null | ano | |
notifyOnUnsubscribe | boolean | ano | |
notifyOnAdd | boolean | ano | |
note | string | ano | |
tags | array of string | ne | |
signatureHtml | string | ne | |
senderEmail | string | ne | |
senderName | string | ne | SE's sendername and replyto of a list (API only in SE, SZ-04). |
replyTo | string | ne |
Odpovědi
- 201 Created:
application/jsonContactListDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | replyTo, senderEmail, senderName, signatureHtml, tags |
| 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. | |
| 409 | conflict | locked, name |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Merge lists into a new list (background)
POST /api/v1/tenants/{tenant}/lists/merge
Oprávnění: modul contacts, úroveň full; klíč s přístupem full
Bulk action Sloučit seznamy kontaktů (SZ-07): body {listIds (2 to 100), name, deleteSources}. Creates the new list named name now (409 conflict name_taken) and merges the members in the background (202 {list, jobId}; the notification list_merged tells when it is done). A contact in more lists keeps its most cautious state, nobody is subscribed again. deleteSources deletes the original lists afterwards (only the lists; 409 conflict locked when one of them is a system list).
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
Tělo požadavku (application/json): Required by the server: listIds, name.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
listIds | array of string | ano | |
name | string | ano | |
deleteSources | boolean | ano |
Odpovědi
- 200 OK:
application/jsonListMergeResult
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | listIds, replyTo, senderEmail, senderName, signatureHtml, tags |
| 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. | |
| 409 | conflict | locked, name |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Change labels of lists
POST /api/v1/tenants/{tenant}/lists/tags
Oprávnění: modul contacts, úroveň full; klíč s přístupem full
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
Tělo požadavku (application/json): Required by the server: ids.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ids | array of string | ano | |
add | array of string | ne | |
remove | array of string | ne | |
tags | array of string | ne |
Odpovědi
- 200 OK:
application/jsonobject
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. |
Get a list
GET /api/v1/tenants/{tenant}/lists/{list_id}
Oprávnění: modul contacts, úroveň read; klíč s přístupem read nebo full · Nástroj MCP: get_list
One list with counts and settings.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Odpovědi
- 200 OK:
application/jsonContactListDetail
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 list
PATCH /api/v1/tenants/{tenant}/lists/{list_id}
Oprávnění: modul contacts, úroveň full; klíč s přístupem full · Nástroj MCP: update_list
Changes a list (name, public name, notifications, note).
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json)
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | ne | |
publicName | string | ne | |
shopId | string or null | ne | |
notifyOnUnsubscribe | boolean | ne | |
notifyOnAdd | boolean | ne | |
note | string | ne | |
tags | array of string | ne | |
signatureHtml | string | ne | |
senderEmail | string | ne | |
senderName | string | ne | SE's sendername and replyto of a list (API only in SE, SZ-04). |
replyTo | string | ne |
Odpovědi
- 200 OK:
application/jsonContactListDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | replyTo, senderEmail, senderName, signatureHtml, tags |
| 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 | locked, name |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Delete a list (only the list, with its contacts, or keeping contacts in other lists)
DELETE /api/v1/tenants/{tenant}/lists/{list_id}
Oprávnění: modul contacts, úroveň full; klíč s přístupem full · Nástroj MCP: delete_list (přes MCP jen s náhledem a potvrzením)
Deletes a manual list (memberships go, contacts stay).
SE's Smazat seznam with its three ways (?mode=, SZ-08): list (default) = only the list, its contacts stay (204); with_contacts = the list and its contacts, keep_used = the list and those of its contacts that are in no other list or segment: both run in the background (202 {jobId}; the notification list_deleted tells when it is done). Unsubscribed contacts keep their suppression, contacts a campaign was just sent to stay. 409 conflict locked for a system list.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
mode | query | string | ne |
Odpovědi
- 200 OK:
application/jsonListJobQueued
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | mode |
| 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 | locked |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Fill empty name day, gender and salutations of the members
POST /api/v1/tenants/{tenant}/lists/{list_id}/autofill
Oprávnění: modul contacts, úroveň full; klíč s přístupem full
Row menu "Doplnit svátek, pohlaví a pozdrav" (SZ-06, core/contact_autofill.py): fills only empty fields of the members; {members, contacts, fields: {column: contacts}}.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json)
object
Odpovědi
- 200 OK:
application/jsonListAutofillResult
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. |
Copy a list with its members
POST /api/v1/tenants/{tenant}/lists/{list_id}/copy
Oprávnění: modul contacts, úroveň full; klíč s přístupem full
Row menu "Vytvořit kopii seznamu" (SZ-06): body {name}; 201 with the new list (members in their states, no automation starts), 404 unknown list, 409 conflict name_taken.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json): Required by the server: name.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | ano |
Odpovědi
- 201 Created:
application/jsonContactListDetail
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | replyTo, senderEmail, senderName, signatureHtml, tags |
| 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 | locked, name |
| 429 | 429 rate_limited: wait Retry-After seconds. |
List members of a list
GET /api/v1/tenants/{tenant}/lists/{list_id}/members
Oprávnění: modul contacts, úroveň read; klíč s přístupem read nebo full · Nástroj MCP: list_list_members
Members of a list. bucket: active, unconfirmed, unsubscribed, bounced, complained, blacklisted.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
bucket | query | one of: active, unconfirmed, unsubscribed, bounced, complained, blacklisted | ne | Bucket filter. |
createdFrom | query | string | ne | |
createdTo | query | string | ne | |
engagement | query | string | ne | |
import | query | string | ne | |
list | query | string | ne | |
listState | query | string | ne | |
page | query | integer | ne | Page number, from 1. default 1, min 1 |
pageSize | query | integer | ne | Items per page, 1 to 100. default 25, min 1, max 100 |
q | query | string | ne | Search text. max 200 chars |
shop | query | string | ne | Only objects of this shop (shop id). |
sort | query | string | ne | Sort fields separated by commas, "-" = descending, at most 3 (e.g. name,-id). |
source | query | string | ne | |
state | query | string | ne | |
status | query | string | ne | Status filter. |
tab | query | string | ne |
Odpovědi
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | q, sort |
| 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 | locked, name |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Add contacts to a list
POST /api/v1/tenants/{tenant}/lists/{list_id}/members
Oprávnění: modul contacts, úroveň full; klíč s přístupem full · Nástroj MCP: add_list_members (přes MCP jen s náhledem a potvrzením)
Adds contacts to a manual list (1 to 1000 ids). Never re-subscribes anyone who unsubscribed.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json): Required by the server: contactIds.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
contactIds | array of string | ano |
Odpovědi
- 200 OK:
application/jsonAddMembersResult
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | contactIds |
| 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 | locked |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Remove contacts from a list
POST /api/v1/tenants/{tenant}/lists/{list_id}/members/remove
Oprávnění: modul contacts, úroveň full; klíč s přístupem full · Nástroj MCP: remove_list_members (přes MCP jen s náhledem a potvrzením)
Removes contacts from a manual list.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json): Required by the server: contactIds.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
contactIds | array of string | ano |
Odpovědi
- 200 OK:
application/jsonRemoveMembersResult
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | contactIds |
| 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 | locked |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Unsubscribe contacts from a list
POST /api/v1/tenants/{tenant}/lists/{list_id}/members/unsubscribe
Oprávnění: modul contacts, úroveň full; klíč s přístupem full
Unsubscribes the given members from this list only (body {contactIds}); 409 locked for lists filled by an e-shop connection. Answers {unsubscribed: n}.
Parametry
| Název | Kde | Typ | Povinné | Popis |
|---|---|---|---|---|
tenant | path | string (uuid) | ano | 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. |
list_id | path | string | ano | Id of the list (string of digits). |
Tělo požadavku (application/json): Required by the server: contactIds.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
contactIds | array of string | ano |
Odpovědi
- 200 OK:
application/jsonobject
Chyby
| Stav | Kód | Hodnoty message |
|---|---|---|
| 400 | validation | contactIds |
| 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 | locked |
| 429 | 429 rate_limited: wait Retry-After seconds. |
Schémata
AddMembersResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
added | number | ano | |
alreadyMember | number | ano | Already confirmed or unconfirmed in the list. |
skipped | number | ano | Unsubscribed from the list, unsubscribed, bounced, complained or suppressed: never re-subscribed by hand. |
ContactListDetail
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
notifyOnUnsubscribe | boolean | ano | |
notifyOnAdd | boolean | ano | |
note | string | ano | Private note for the team. |
signatureHtml | string | ano | SE's Podpis v e-mailu pro tento seznam kontaktů (HTML), sanitized: {{cl_signature}} of e-mails to the list. |
senderEmail | string | ano | SE's e-mail odesílatele of the list (lower case, '' = none): the signature goes into every e-mail sent from this address, and the list's e-mail notices go to the account's user with this address. |
id | string | ano | |
name | string | ano | |
publicName | string | ano | Name shown on the unsubscribe page; empty = the name is used. |
shopId | string or null | ano | null = list of the whole tenant, not bound to one e-shop. |
systemKind | one of: form, shop_contacts, shop_newsletter, shop_unsubscribed, null | ano | |
locked | boolean | ano | System lists cannot be deleted. |
manualMembers | boolean | ano | False for lists filled by an e-shop connection: members are not added or removed by hand (409). |
tags | array of string | ano | Labels (štítky), at most 20. |
counts | ListCounts | ano | |
createdAt | string | ano |
ContactListSummary
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
id | string | ano | |
name | string | ano | |
publicName | string | ano | Name shown on the unsubscribe page; empty = the name is used. |
shopId | string or null | ano | null = list of the whole tenant, not bound to one e-shop. |
systemKind | one of: form, shop_contacts, shop_newsletter, shop_unsubscribed, null | ano | |
locked | boolean | ano | System lists cannot be deleted. |
manualMembers | boolean | ano | False for lists filled by an e-shop connection: members are not added or removed by hand (409). |
tags | array of string | ano | Labels (štítky), at most 20. |
counts | ListCounts | ano | |
createdAt | string | ano |
Error
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
error | object | ano |
{
"error": {
"code": "validation",
"message": "email"
}
}GridTagsInput
Bulk label change: add and remove, or tags = the new labels of every row.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
ids | array of string | ano | |
add | array of string | ne | |
remove | array of string | ne | |
tags | array of string | ne |
ListAutofillResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
members | number | ano | |
contacts | number | ano | |
fields | map of number | ano |
ListCounts
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
total | number | ano | Members without the removed state; the sum of byBucket. |
byBucket | object | ano |
ListInput
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
name | string | ano | |
publicName | string | ano | |
shopId | string or null | ano | |
notifyOnUnsubscribe | boolean | ano | |
notifyOnAdd | boolean | ano | |
note | string | ano | |
tags | array of string | ne | |
signatureHtml | string | ne | |
senderEmail | string | ne | |
senderName | string | ne | SE's sendername and replyto of a list (API only in SE, SZ-04). |
replyTo | string | ne |
ListJobQueued
202 of a deletion with contacts or of a merge: the work runs in the background, a notification tells when done.
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
jobId | string or null | ano | |
queued | boolean | ne |
ListMember
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
listState | one of: unsubscribed, confirmed, unconfirmed | ano | State in this list; removed members are never returned. |
bucket | one of: active, unsubscribed, bounced, complained, blacklisted, unconfirmed | ano | |
addedAt | string | ano | |
changedAt | string | ano | |
id | string | ano | |
email | string | ano | |
firstName | string | ano | |
lastName | string | ano | |
status | one of: pending, subscribed, unsubscribed, bounced, complained, customer | ano | |
engagement | one of: A, B, C, D, E, N | ano | |
excluded | boolean | ano | SE "Vyloučené": long inactive yet mailed often (recomputed weekly with the engagement). |
shopId | string or null | ano | Main e-shop (contacts.shop_id), null when unknown. |
suppressionReason | one of: invalid, manual, unsubscribed, hard_bounce, complaint, soft_bounce_limit, null | ano | Set when the address is on the tenant suppression list. |
blacklisted | boolean | ne | On the tenant's blacklist ("Na blacklistu"): a manual entry, or an entry of SmartEmailing's blacklist that keeps its own reason (migration 0180). Older servers leave it out: then suppressionReason 'manual' decides. |
blacklistedAt | string or null | ne | When the address went on the blacklist (the suppression's time), null when it is not on it ("Přidán na blacklist"). |
state | one of: active, bounced, blacklisted | ne | SmartEmailing's 3-value contact state; older servers leave it out (contactState derives it). |
createdAt | string | ano | |
extra | map of boolean or string or number or null | ne | Values of the extra columns asked for (ContactQuery.fields): dates as YYYY-MM-DD, times as ISO. |
ListMergeInput
Bulk action Sloučit seznamy kontaktů (SZ-07).
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
listIds | array of string | ano | |
name | string | ano | |
deleteSources | boolean | ano |
ListMergeResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
list | ContactListDetail | ano | |
jobId | string or null | ano |
RemoveMembersResult
| Pole | Typ | Povinné | Popis |
|---|---|---|---|
removed | number | ano |