Campaigns

One-off e-mail campaigns (newsletters): draft, audience, content, test, approve (send now or schedule), pause, resume, cancel, language variants.

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

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

Operácie#

List campaigns#

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

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

Campaigns (draft, scheduled, sending, paused, completed, cancelled) with recipients and stats.

Parametre

Odpovede

• 200 OK: application/json object

Chyby

Create a campaign (draft)#

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

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

Creates a campaign draft (only name and shopId are required). Then save_campaign_content, preview_campaign_audience, send_campaign_test and send_campaign.

Parametre

Telo požiadavky (application/json)

Odpovede

• 201 Created: application/json CampaignDetail

Chyby

Count and explain the recipients of an audience#

POST /api/v1/tenants/{tenant}/campaigns/audience

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

Counts recipients of an audience without saving: matched, recipients and every excluded reason.

AudienceCount of an audience for a shop: matched, recipients and one reason per left-out contact. anyShop true = the audience of a language variant (lists and segments of any shop).

Parametre

Telo požiadavky (application/json)

object

Odpovede

• 200 OK: application/json AudienceCount

Chyby

Change labels of campaigns#

POST /api/v1/tenants/{tenant}/campaigns/tags

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

Parametre

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

Odpovede

• 200 OK: application/json object

Chyby

Get a campaign#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}

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

One campaign with audience, sender, tracking and state.

Parametre

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Update a campaign draft#

PATCH /api/v1/tenants/{tenant}/campaigns/{campaign_id}

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

Changes a draft campaign (any CampaignInput field).

Parametre

Telo požiadavky (application/json)

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Delete a campaign draft#

DELETE /api/v1/tenants/{tenant}/campaigns/{campaign_id}

Oprávnenie: modul campaigns, úroveň full; kľúč s prístupom full · Nástroj MCP: delete_campaign (cez MCP len s náhľadom a potvrdením)

Deletes a draft campaign that sent nothing.

Parametre

Odpovede

• 204 No content

Chyby

Approve a campaign: send now or schedule#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/approve

Oprávnenie: modul campaigns, úroveň full; kľúč s prístupom full · Nástroj MCP: send_campaign (cez MCP len s náhľadom a potvrdením)

Approves a draft campaign and sends it now (sendAt null) or schedules it (sendAt ISO time, 5 minutes to 365 days ahead). The preview shows subject, sender and the exact recipient count; expectedRecipients defaults to that count.

Body {sendAt: ISO time in UTC or null (now), expectedRecipients: the number the user confirmed}.

Parametre

Telo požiadavky (application/json)

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Cancel a scheduled or paused campaign#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/cancel

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

Cancels a campaign for good (what was sent stays in the statistics).

Parametre

Telo požiadavky (application/json)

object

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Get the content of a campaign#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/content

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

Content of a campaign (editor, html, design, version).

Parametre

Odpovede

• 200 OK: application/json EmailContent

Chyby

Save the content of a campaign draft#

PUT /api/v1/tenants/{tenant}/campaigns/{campaign_id}/content

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

Saves the content of a draft campaign (copy a template: get_template, then save its content here).

Parametre

Telo požiadavky (application/json)

Odpovede

• 200 OK: application/json EmailContent

Chyby

Pause a sending or scheduled campaign#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/pause

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

Pauses a scheduled or sending campaign.

Parametre

Telo požiadavky (application/json)

object

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Render a campaign for one contact#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/preview

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

The e-mail as one contact would get it: body {email} of a contact of the tenant; answers {subject, preheader, html} with every merge tag filled and sample links. Nothing is sent or recorded. It shows one contact's data (name, e-mail, custom fields, orders in scripts), so it needs the module contacts too (read): campaigns read alone (content manager, developer) neither reads a contact nor learns whether an address is one (review of batch 8).

Parametre

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

Odpovede

• 200 OK: application/json CampaignPreview

Chyby

Resume a paused campaign#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/resume

Oprávnenie: modul campaigns, úroveň full; kľúč s prístupom full · Nástroj MCP: resume_campaign (cez MCP len s náhľadom a potvrdením)

Resumes a paused campaign (it sends again, or goes back to scheduled when its time is ahead).

Parametre

Telo požiadavky (application/json)

object

Odpovede

• 200 OK: application/json CampaignDetail

Chyby

Statistics of a campaign by provider and domain#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/stats

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

Parametre

Odpovede

• 200 OK: application/json object

Chyby

Send a test e-mail of a campaign#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/test

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

Sends a test e-mail of the campaign to the account's test addresses only (list_test_recipients).

Parametre

Telo požiadavky (application/json)

Odpovede

• 200 OK: application/json TestSendResult

Chyby

Get the language variants of a campaign#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants

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

Parametre

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Create language variants of a campaign#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants

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

Duplicate as variant: body {shopId, label, sourceLabel?}. Answers the new variant's id and the group.

Parametre

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

Odpovede

• 201 Created: application/json CampaignVariantGroup

Chyby

Change the language variants of a campaign#

PUT /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants

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

Order and labels of the group: body {variants: [{id, label}] in the new order, every variant once}.

Parametre

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

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Approve the language variants (send or schedule)#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/approve

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

One send action for every variant: body {sendAt: ISO time or null (now), expectedRecipients: {id: final}}.

Parametre

Telo požiadavky (application/json)

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Cancel the language variants#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/cancel

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

Parametre

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Pause the language variants#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/pause

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

Parametre

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Preview the audience split of language variants#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/preview

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

Final numbers per variant: matched, recipients of its own audience, taken by an earlier variant, final.

Parametre

Odpovede

• 200 OK: application/json VariantPreview

Chyby

Resume the language variants#

POST /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/resume

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

Parametre

Odpovede

• 200 OK: application/json CampaignVariantGroup

Chyby

Statistics of the language variants#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/variants/stats

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

Statistics per variant and combined (unique contacts: one variant per contact, so the sums add up).

Parametre

Odpovede

• 200 OK: application/json VariantStats

Chyby

List saved content versions of a campaign#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/versions

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

Parametre

Odpovede

• 200 OK: application/json ContentVersionList

Chyby

Get one content version of a campaign#

GET /api/v1/tenants/{tenant}/campaigns/{campaign_id}/versions/{version_id}

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

Parametre

Odpovede

• 200 OK: application/json ContentVersionDetail

Chyby

List verified senders#

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

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

Sender addresses per shop (only verified ones may send).

Parametre

Odpovede

• 200 OK: application/json object

Chyby

Schémy#

ApproveInput#

AudienceCount#

BoxPadding#

CampaignAudience#

CampaignDetail#

CampaignHeader#

CampaignInput#

CampaignLinkParam#

CampaignListItem#

CampaignPreview#

The e-mail as one contact would get it (POST /campaigns/{id}/preview): every merge tag filled, sample links.

CampaignStats#

Unique contacts per event type.

CampaignUtm#

CampaignVariant#

One variant: a whole campaign of its own shop (content, subject, sender, feeds) with an audience chosen by hand.

CampaignVariantGroup#

ContentVersion#

One entry of the content history (Historie uložení).

ContentVersionDetail#

ContentVersionList#

Currency#

one of: CZK, EUR

EmailContent#

E-mail content of a template or a campaign.

EmailContentInput#

EmailDesign#

Source of a visual design: MJML plus the global styles, so the editor reopens it exactly.

EmailStyles#

Global look of a visual design. The editor writes it as MJML attributes; every element can override it.

Error#

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

GridTagsInput#

Bulk label change: add and remove, or tags = the new labels of every row.

Lang#

one of: cs, sk

MagicBackground#

A background of the Magic editor: a plain colour, a linear gradient or a picture (https).

MagicStyles#

SendTiming#

one of: now, schedule, later

Sender#

TestSendResult#

VariantApproveInput#

VariantPreview#

VariantPreviewItem#

Counts of one variant before sending: its own audience, the recipients an earlier variant takes, the final number.

VariantStats#