Marketing: Automatisierungen (Flows)

Marketing-Automatisierungen mit Auslöser und Schritten anlegen und ändern, mit der Handlung `marketing.send` aktivieren, pausieren und löschen.

Für Entwickler

Voraussetzungen

Recht `marketing:read` zum Lesen, `marketing:write` zum Anlegen, Ändern, Pausieren und Löschen
Aktivieren: zusätzlich die Handlung `action:marketing.send`
Schritte mit Tags: zusätzlich `guests:write`
Plan-Merkmal „Marketing"

EINE AUTOMATISIERUNG IST AUSLÖSER PLUS SCHRITTE. Der Auslöser (`trigger`) sagt, wann ein Gast startet: bei einem Ereignis (`GUEST_CREATED`, `NEWSLETTER_CONFIRMED`, Reservierung angelegt, bestätigt, storniert, nicht erschienen, abgeschlossen) oder zu einer Zeit (`BIRTHDAY` mit `daysBefore` und `hour`, `SCHEDULE` mit `frequency`, `hour` und `listId`, `INACTIVITY` mit `days` und `hour`). Ereignis- und Zeitauslöser dürfen einen Zielgruppenfilter (`filter`) im Format der Listen-Bedingungen tragen.

DIE SCHRITTE (`definition.steps`) laufen der Reihe nach: `SEND_EMAIL`/`SEND_SMS` mit `templateId` (Vorlage des passenden Kanals), `WAIT` mit `amount` und `unit` (`MINUTES`, `HOURS`, `DAYS`, zusammen höchstens 365 Tage), `CONDITION` mit `conditions` und den Zweigen `then`/`else`, `GET_DATA` (Reservierungsdaten für Platzhalter), `ADD_TAG`/`REMOVE_TAG` mit `tag`, `EXIT`. Jede Schritt-`id` ist eindeutig; höchstens 60 Schritte und fünf Verzweigungsebenen. In Bedingungen stehen zusätzlich die `ctx.`-Felder zur Verfügung (Personen, Status und Bereich der auslösenden Reservierung, ob die letzte Nachricht geöffnet oder geklickt wurde).

ARBEITSSTAND UND VERSION. `POST` legt einen ENTWURF (`DRAFT`) an, `PATCH` ändert den Arbeitsstand. Wirksam wird er erst mit `POST …/activate`: das friert Auslöser und Schritte als neue Version ein (`version` steigt) und setzt den Status auf `ACTIVE`. Laufende Durchläufe arbeiten mit IHRER Version weiter. Ändern Sie eine aktive Automatisierung, zeigt `hasUnpublishedChanges: true`, dass der Arbeitsstand noch nicht gilt — bis zum nächsten `…/activate`. Name, Beschreibung und `reentryDays` gelten sofort — ein neuer `reentryDays` an einer schon aktivierten Automatisierung ändert deshalb, wer künftig startet, und verlangt `action:marketing.send` (sonst 403 `forbidden_action`, `reason: "marketing-flow-reentry-live"`).

AKTIVIEREN LÖST WERBUNG AUS und verlangt deshalb dieselbe Handlung wie das Senden einer Kampagne: `action:marketing.send`, dazu Pflicht-`Idempotency-Key` und eine Bremse von 60 Aktivierungen je zehn Minuten und Betrieb, gemeinsam gezählt mit Aktivieren und Pausieren im Dashboard (429 mit `Retry-After`). Nachrichten bekommen nur Gäste mit bestätigter Einwilligung für den Kanal; die Sperrliste gilt wie bei Kampagnen. `PAUSED` heisst: keine neuen Starts, laufende Durchläufe warten. Pausieren braucht keine Handlung und hat keine eigene Bremse — ein Notstopp darf nicht an einem Kontingent scheitern.

TAGS SIND GASTDATEN. Enthält eine Automatisierung `ADD_TAG` oder `REMOVE_TAG`, braucht der Schlüssel zum Anlegen, Ändern und Aktivieren zusätzlich `guests:write` — sonst 403 mit `module: "guests"`.

WIEDEREINTRITT: `reentryDays: null` heisst „jeder Gast nur einmal"; eine Zahl ist der Mindestabstand in Tagen zwischen zwei Starts desselben Gastes. Geburtstagsgrüsse brauchen den Geburtstag am Gast (`birthday` in `/api/v1/guests`).

LÖSCHEN bricht laufende Durchläufe ab (`canceledRuns`) und überspringt noch nicht versendete Nachrichten (`skippedMessages`). Bereits versendete Nachrichten bleiben im Protokoll des Gastes.

Die Routen

GET/api/v1/marketing/flows

Automatisierungen mit Status, Auslöser und laufenden Durchläufen lesen.

Rechte

marketing:read

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Abfrageparameter

Name	Typ	Bedeutung
`status`	DRAFT \| ACTIVE \| PAUSED	`DRAFT` Entwurf (nie aktiviert), `ACTIVE` startet Gäste, `PAUSED` startet keine neuen.
`q`	string, 2–200 Zeichen	Suche in Name und Beschreibung.
`limit`	integer 1–200Vorgabe: 50	Zeilen je Seite.
`cursor`	undurchsichtiger Zeiger	`nextCursor` der vorigen Antwort.

Mögliche Fehler

validation — Unbekannter Parameter oder Wert.
forbidden — Dem Schlüssel fehlt `marketing:read`.
plan_upgrade_required — Der Plan enthält kein Marketing.

Zeilen mit `triggerType`, `activeRuns`, `enrolledCount`, `completedCount`, `hasUnpublishedChanges`. Auch `sort`, `dir`, `ids`, `updatedAtFrom`, `updatedAtTo`, `includeTotal`.

POST/api/v1/marketing/flows

Eine Automatisierung als Entwurf anlegen.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Kopfzeilen

Name	Typ	Bedeutung
`Idempotency-Key`Pflicht	string bis 255 Zeichen	PFLICHT beim Anlegen.

Felder im Rumpf

Name	Typ	Bedeutung
`name`Pflicht	string, 1–160 Zeichen	Interner Name.
`description`	string bis 500 Zeichen oder null	Wofür die Automatisierung gedacht ist.
`trigger`Pflicht	Auslöser-Objekt	Siehe oben; `SCHEDULE` verlangt eine eigene `listId`.
`definition`Pflicht	{ version: 1, steps: [...] }	Die Schritte; eine leere Liste ist als Entwurf erlaubt, aber nicht aktivierbar.
`reentryDays`Pflicht	integer 0–3650 oder null	`null` = jeder Gast nur einmal; sonst Mindestabstand in Tagen.

Mögliche Fehler

validation — Schema verletzt, fremde oder kanalfremde Vorlage, fremde Liste, fremder Bereich bzw. fremde Kampagne in einer Bedingung (`invalid_reference`).
forbidden — Dem Schlüssel fehlt `marketing:write`, oder Tag-Schritte ohne `guests:write`.
conflict — Der Betrieb hat bereits 100 Automatisierungen (`reason: "marketing-flow-limit"`).

Antwortet mit 201 und der Automatisierung inklusive `stats`.

GET/api/v1/marketing/flows/{id}

Eine Automatisierung mit Arbeitsstand und Kennzahlen lesen.

Rechte

marketing:read

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung; eine fremde ergibt 404.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

`stats`: gestartet, abgeschlossen, laufend, wartend, fehlgeschlagen, Nachrichten gesendet/übersprungen, messbar, geöffnet, geklickt.

PATCH/api/v1/marketing/flows/{id}

Den Arbeitsstand ändern; bei einer aktiven Automatisierung wirksam erst nach erneutem Aktivieren.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Felder im Rumpf

Name	Typ	Bedeutung
`definition`	{ version: 1, steps: [...] }	Ersetzt alle Schritte des Arbeitsstands.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.
validation — Schema verletzt oder fremder Verweis.
forbidden — Tag-Schritte ohne `guests:write`.
forbidden_action — Neuer `reentryDays` an einer schon aktivierten Automatisierung ohne `action:marketing.send` (`reason: "marketing-flow-reentry-live"`).

Alle Felder aus `POST`, jedes einzeln und optional.

DELETE/api/v1/marketing/flows/{id}

Eine Automatisierung löschen; laufende Durchläufe werden abgebrochen.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

Antwort `{ "id", "deleted": true, "canceledRuns", "skippedMessages" }`.

POST/api/v1/marketing/flows/{id}/activate

Den Arbeitsstand als neue Version einfrieren und aktivieren bzw. eine pausierte Automatisierung fortsetzen.

Rechte

marketing:writeaction:marketing.send

Alle genannten Rechte zusammen, nicht wahlweise.

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Kopfzeilen

Name	Typ	Bedeutung
`Idempotency-Key`Pflicht	string bis 255 Zeichen	PFLICHT — eine Wiederholung friert keine zweite Version ein.

Mögliche Fehler

forbidden_action — Dem Schlüssel fehlt `action:marketing.send`.
forbidden — Tag-Schritte ohne `guests:write`.
conflict — Keine Schritte (`marketing-flow-empty`), unvollständig (`marketing-flow-invalid`), fremder Verweis oder gleichzeitig geändert (`marketing-flow-conflict`).
not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.
rate_limited — Mehr als 60 Aktivierungen in zehn Minuten (`scope: "marketing.flowStatus"`).

Leerer Rumpf. Im Prüfmodus zusätzlich `publishesNewVersion`: ob eine neue Version entstünde oder nur fortgesetzt würde.

POST/api/v1/marketing/flows/{id}/pause

Keine neuen Starts mehr; laufende Durchläufe warten.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Mögliche Fehler

conflict — Die Automatisierung ist nicht aktiv (`marketing-flow-not-active`).
not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

Leerer Rumpf; eine bereits pausierte Automatisierung bleibt es (200).

Codebeispiele

curl — Automatisierung anlegen

curl

1curl -sS -X POST https://tactictable.com/api/v1/marketing/flows \2  -H "Authorization: Bearer tt_live_if3u5vp6maf67xmw_PT1xP8EQF7reKUtLcZ7v9z5qaRKmoxeHmd27JpaDvfM" \3  -H "Content-Type: application/json" \4  -H "Idempotency-Key: 3a8f2d61-9c47-4e05-b2a8-6f1d0e7c9b34" \5  -d '{6  "name": "Nach der Newsletter-Anmeldung",7  "trigger": { "type": "NEWSLETTER_CONFIRMED" },8  "definition": {9    "version": 1,10    "steps": [11      { "id": "s1", "type": "WAIT", "amount": 2, "unit": "DAYS" },12      {13        "id": "s2",14        "type": "CONDITION",15        "label": "Hat schon einmal geklickt?",16        "conditions": { "operator": "AND", "conditions": [{ "field": "campaign", "operator": "CLICKED", "campaign": { "withinDays": 365 } }] },17        "then": [{ "id": "s3", "type": "SEND_EMAIL", "templateId": "ce6d92ec-3bd6-4201-a65f-0b4bd7fd30b4" }],18        "else": [{ "id": "s4", "type": "SEND_SMS", "templateId": "f3084ee4-7379-43ba-adb4-4a00b0935db5" }]19      }20    ]21  },22  "reentryDays": null23}'

Legt nur einen Entwurf an. Wer klickt, bekommt nach zwei Tagen eine E-Mail, alle anderen eine SMS.

curl — aktivieren

curl

curl -sS -X POST https://tactictable.com/api/v1/marketing/flows/bcb64431-fdd6-4f1e-964c-db2788947b3e/activate \
  -H "Authorization: Bearer tt_live_if3u5vp6maf67xmw_PT1xP8EQF7reKUtLcZ7v9z5qaRKmoxeHmd27JpaDvfM" \
  -H "Idempotency-Key: aktivieren-bcb64431-fdd6-4f1e-964c-db2788947b3e-v1"

Ab jetzt starten Gäste, sobald der Auslöser eintritt. Der Schlüssel braucht `action:marketing.send`.

Antwort 200 — aktiviert

JSON

1{2  "id": "bcb64431-fdd6-4f1e-964c-db2788947b3e",3  "name": "Nach der Newsletter-Anmeldung",4  "description": null,5  "status": "ACTIVE",6  "trigger": { "type": "NEWSLETTER_CONFIRMED" },7  "definition": {8    "version": 1,9    "steps": [10      { "id": "s1", "type": "WAIT", "amount": 2, "unit": "DAYS" },11      {12        "id": "s2",13        "type": "CONDITION",14        "label": "Hat schon einmal geklickt?",15        "conditions": { "operator": "AND", "conditions": [{ "field": "campaign", "operator": "CLICKED", "campaign": { "withinDays": 365 } }] },16        "then": [{ "id": "s3", "type": "SEND_EMAIL", "templateId": "ce6d92ec-3bd6-4201-a65f-0b4bd7fd30b4" }],17        "else": [{ "id": "s4", "type": "SEND_SMS", "templateId": "f3084ee4-7379-43ba-adb4-4a00b0935db5" }]18      }19    ]20  },21  "reentryDays": null,22  "version": 1,23  "activeVersionId": "0b7d2f44-6a31-4c8e-9e25-1f3a8c6d4b70",24  "activeTriggerType": "NEWSLETTER_CONFIRMED",25  "hasUnpublishedChanges": false,26  "stats": { "enrolled": 0, "completed": 0, "active": 0, "waiting": 0, "failed": 0, "exited": 0, "canceled": 0, "messagesQueued": 0, "messagesSent": 0, "messagesSkipped": 0, "messagesFailed": 0, "tracked": 0, "opened": 0, "clicked": 0 },27  "createdAt": "2026-09-20T10:02:11.000Z",28  "updatedAt": "2026-09-20T10:05:40.000Z"29}

Python — Geburtstagsgruss einrichten

Python

1import uuid2 3import requests4 5BASIS = "https://tactictable.com/api/v1"6 7 8def geburtstagsgruss(sitzung: requests.Session, vorlage_id: str) -> dict:9    rumpf = {10        "name": "Geburtstagsgruss",11        "trigger": {"type": "BIRTHDAY", "daysBefore": 0, "hour": 9},12        "definition": {"version": 1, "steps": [{"id": "gruss", "type": "SEND_EMAIL", "templateId": vorlage_id}]},13        "reentryDays": 300,14    }15    angelegt = sitzung.post(f"{BASIS}/marketing/flows", json=rumpf, headers={"Idempotency-Key": str(uuid.uuid4())}, timeout=20)16    angelegt.raise_for_status()17    flow_id = angelegt.json()["id"]18 19    aktiv = sitzung.post(f"{BASIS}/marketing/flows/{flow_id}/activate", headers={"Idempotency-Key": f"aktivieren-{flow_id}"}, timeout=20)20    aktiv.raise_for_status()21    return aktiv.json()

`reentryDays: 300` lässt denselben Gast im nächsten Jahr wieder starten, verhindert aber einen zweiten Gruss im selben Jahr. Die Sitzung trägt die Bearer-Kopfzeile.

TypeScript — alle aktiven Automatisierungen pausieren

TypeScript

1export async function allesPausieren(token: string): Promise<number> {2    const kopf = { Authorization: 'Bearer ' + token }3    const liste = await fetch('https://tactictable.com/api/v1/marketing/flows?status=ACTIVE&limit=200', { headers: kopf })4    if (!liste.ok) throw new Error('HTTP ' + liste.status)5    const { data } = (await liste.json()) as { data: Array<{ id: string }> }6    for (const flow of data) {7        const antwort = await fetch('https://tactictable.com/api/v1/marketing/flows/' + encodeURIComponent(flow.id) + '/pause', { method: 'POST', headers: kopf })8        if (!antwort.ok) throw new Error('HTTP ' + antwort.status)9    }10    return data.length11}

Pausieren braucht keine Handlung — es hält Werbung an. Laufende Durchläufe warten, bis wieder aktiviert wird.

Siehe auch

← Zurück zu REST-API

Die Routen

GET/api/v1/marketing/flows

Automatisierungen mit Status, Auslöser und laufenden Durchläufen lesen.

Rechte

marketing:read

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Abfrageparameter

Name	Typ	Bedeutung
`status`	DRAFT \| ACTIVE \| PAUSED	`DRAFT` Entwurf (nie aktiviert), `ACTIVE` startet Gäste, `PAUSED` startet keine neuen.
`q`	string, 2–200 Zeichen	Suche in Name und Beschreibung.
`limit`	integer 1–200Vorgabe: 50	Zeilen je Seite.
`cursor`	undurchsichtiger Zeiger	`nextCursor` der vorigen Antwort.

Mögliche Fehler

validation — Unbekannter Parameter oder Wert.
forbidden — Dem Schlüssel fehlt `marketing:read`.
plan_upgrade_required — Der Plan enthält kein Marketing.

Zeilen mit `triggerType`, `activeRuns`, `enrolledCount`, `completedCount`, `hasUnpublishedChanges`. Auch `sort`, `dir`, `ids`, `updatedAtFrom`, `updatedAtTo`, `includeTotal`.

POST/api/v1/marketing/flows

Eine Automatisierung als Entwurf anlegen.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Kopfzeilen

Name	Typ	Bedeutung
`Idempotency-Key`Pflicht	string bis 255 Zeichen	PFLICHT beim Anlegen.

Felder im Rumpf

Name	Typ	Bedeutung
`name`Pflicht	string, 1–160 Zeichen	Interner Name.
`description`	string bis 500 Zeichen oder null	Wofür die Automatisierung gedacht ist.
`trigger`Pflicht	Auslöser-Objekt	Siehe oben; `SCHEDULE` verlangt eine eigene `listId`.
`definition`Pflicht	{ version: 1, steps: [...] }	Die Schritte; eine leere Liste ist als Entwurf erlaubt, aber nicht aktivierbar.
`reentryDays`Pflicht	integer 0–3650 oder null	`null` = jeder Gast nur einmal; sonst Mindestabstand in Tagen.

Mögliche Fehler

validation — Schema verletzt, fremde oder kanalfremde Vorlage, fremde Liste, fremder Bereich bzw. fremde Kampagne in einer Bedingung (`invalid_reference`).
forbidden — Dem Schlüssel fehlt `marketing:write`, oder Tag-Schritte ohne `guests:write`.
conflict — Der Betrieb hat bereits 100 Automatisierungen (`reason: "marketing-flow-limit"`).

Antwortet mit 201 und der Automatisierung inklusive `stats`.

GET/api/v1/marketing/flows/{id}

Eine Automatisierung mit Arbeitsstand und Kennzahlen lesen.

Rechte

marketing:read

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung; eine fremde ergibt 404.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

`stats`: gestartet, abgeschlossen, laufend, wartend, fehlgeschlagen, Nachrichten gesendet/übersprungen, messbar, geöffnet, geklickt.

PATCH/api/v1/marketing/flows/{id}

Den Arbeitsstand ändern; bei einer aktiven Automatisierung wirksam erst nach erneutem Aktivieren.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Felder im Rumpf

Name	Typ	Bedeutung
`definition`	{ version: 1, steps: [...] }	Ersetzt alle Schritte des Arbeitsstands.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.
validation — Schema verletzt oder fremder Verweis.
forbidden — Tag-Schritte ohne `guests:write`.
forbidden_action — Neuer `reentryDays` an einer schon aktivierten Automatisierung ohne `action:marketing.send` (`reason: "marketing-flow-reentry-live"`).

Alle Felder aus `POST`, jedes einzeln und optional.

DELETE/api/v1/marketing/flows/{id}

Eine Automatisierung löschen; laufende Durchläufe werden abgebrochen.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Mögliche Fehler

not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

Antwort `{ "id", "deleted": true, "canceledRuns", "skippedMessages" }`.

POST/api/v1/marketing/flows/{id}/activate

Den Arbeitsstand als neue Version einfrieren und aktivieren bzw. eine pausierte Automatisierung fortsetzen.

Rechte

marketing:writeaction:marketing.send

Alle genannten Rechte zusammen, nicht wahlweise.

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Kopfzeilen

Name	Typ	Bedeutung
`Idempotency-Key`Pflicht	string bis 255 Zeichen	PFLICHT — eine Wiederholung friert keine zweite Version ein.

Mögliche Fehler

forbidden_action — Dem Schlüssel fehlt `action:marketing.send`.
forbidden — Tag-Schritte ohne `guests:write`.
conflict — Keine Schritte (`marketing-flow-empty`), unvollständig (`marketing-flow-invalid`), fremder Verweis oder gleichzeitig geändert (`marketing-flow-conflict`).
not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.
rate_limited — Mehr als 60 Aktivierungen in zehn Minuten (`scope: "marketing.flowStatus"`).

Leerer Rumpf. Im Prüfmodus zusätzlich `publishesNewVersion`: ob eine neue Version entstünde oder nur fortgesetzt würde.

POST/api/v1/marketing/flows/{id}/pause

Keine neuen Starts mehr; laufende Durchläufe warten.

Rechte

marketing:write

Plan-Merkmal marketing — fehlt es dem Betrieb, antwortet die Route mit 402 plan_upgrade_required.

Pfad

Name	Typ	Bedeutung
`{id}`Pflicht	UUID	Kennung der Automatisierung.

Mögliche Fehler

conflict — Die Automatisierung ist nicht aktiv (`marketing-flow-not-active`).
not_found — Diese Automatisierung gibt es für diesen Betrieb nicht.

Leerer Rumpf; eine bereits pausierte Automatisierung bleibt es (200).

Codebeispiele

curl — Automatisierung anlegen

curl

1curl -sS -X POST https://tactictable.com/api/v1/marketing/flows \2  -H "Authorization: Bearer tt_live_if3u5vp6maf67xmw_PT1xP8EQF7reKUtLcZ7v9z5qaRKmoxeHmd27JpaDvfM" \3  -H "Content-Type: application/json" \4  -H "Idempotency-Key: 3a8f2d61-9c47-4e05-b2a8-6f1d0e7c9b34" \5  -d '{6  "name": "Nach der Newsletter-Anmeldung",7  "trigger": { "type": "NEWSLETTER_CONFIRMED" },8  "definition": {9    "version": 1,10    "steps": [11      { "id": "s1", "type": "WAIT", "amount": 2, "unit": "DAYS" },12      {13        "id": "s2",14        "type": "CONDITION",15        "label": "Hat schon einmal geklickt?",16        "conditions": { "operator": "AND", "conditions": [{ "field": "campaign", "operator": "CLICKED", "campaign": { "withinDays": 365 } }] },17        "then": [{ "id": "s3", "type": "SEND_EMAIL", "templateId": "ce6d92ec-3bd6-4201-a65f-0b4bd7fd30b4" }],18        "else": [{ "id": "s4", "type": "SEND_SMS", "templateId": "f3084ee4-7379-43ba-adb4-4a00b0935db5" }]19      }20    ]21  },22  "reentryDays": null23}'

Legt nur einen Entwurf an. Wer klickt, bekommt nach zwei Tagen eine E-Mail, alle anderen eine SMS.

curl — aktivieren

curl

curl -sS -X POST https://tactictable.com/api/v1/marketing/flows/bcb64431-fdd6-4f1e-964c-db2788947b3e/activate \
  -H "Authorization: Bearer tt_live_if3u5vp6maf67xmw_PT1xP8EQF7reKUtLcZ7v9z5qaRKmoxeHmd27JpaDvfM" \
  -H "Idempotency-Key: aktivieren-bcb64431-fdd6-4f1e-964c-db2788947b3e-v1"

Ab jetzt starten Gäste, sobald der Auslöser eintritt. Der Schlüssel braucht `action:marketing.send`.

Antwort 200 — aktiviert

JSON

1{2  "id": "bcb64431-fdd6-4f1e-964c-db2788947b3e",3  "name": "Nach der Newsletter-Anmeldung",4  "description": null,5  "status": "ACTIVE",6  "trigger": { "type": "NEWSLETTER_CONFIRMED" },7  "definition": {8    "version": 1,9    "steps": [10      { "id": "s1", "type": "WAIT", "amount": 2, "unit": "DAYS" },11      {12        "id": "s2",13        "type": "CONDITION",14        "label": "Hat schon einmal geklickt?",15        "conditions": { "operator": "AND", "conditions": [{ "field": "campaign", "operator": "CLICKED", "campaign": { "withinDays": 365 } }] },16        "then": [{ "id": "s3", "type": "SEND_EMAIL", "templateId": "ce6d92ec-3bd6-4201-a65f-0b4bd7fd30b4" }],17        "else": [{ "id": "s4", "type": "SEND_SMS", "templateId": "f3084ee4-7379-43ba-adb4-4a00b0935db5" }]18      }19    ]20  },21  "reentryDays": null,22  "version": 1,23  "activeVersionId": "0b7d2f44-6a31-4c8e-9e25-1f3a8c6d4b70",24  "activeTriggerType": "NEWSLETTER_CONFIRMED",25  "hasUnpublishedChanges": false,26  "stats": { "enrolled": 0, "completed": 0, "active": 0, "waiting": 0, "failed": 0, "exited": 0, "canceled": 0, "messagesQueued": 0, "messagesSent": 0, "messagesSkipped": 0, "messagesFailed": 0, "tracked": 0, "opened": 0, "clicked": 0 },27  "createdAt": "2026-09-20T10:02:11.000Z",28  "updatedAt": "2026-09-20T10:05:40.000Z"29}

Python — Geburtstagsgruss einrichten

Python

1import uuid2 3import requests4 5BASIS = "https://tactictable.com/api/v1"6 7 8def geburtstagsgruss(sitzung: requests.Session, vorlage_id: str) -> dict:9    rumpf = {10        "name": "Geburtstagsgruss",11        "trigger": {"type": "BIRTHDAY", "daysBefore": 0, "hour": 9},12        "definition": {"version": 1, "steps": [{"id": "gruss", "type": "SEND_EMAIL", "templateId": vorlage_id}]},13        "reentryDays": 300,14    }15    angelegt = sitzung.post(f"{BASIS}/marketing/flows", json=rumpf, headers={"Idempotency-Key": str(uuid.uuid4())}, timeout=20)16    angelegt.raise_for_status()17    flow_id = angelegt.json()["id"]18 19    aktiv = sitzung.post(f"{BASIS}/marketing/flows/{flow_id}/activate", headers={"Idempotency-Key": f"aktivieren-{flow_id}"}, timeout=20)20    aktiv.raise_for_status()21    return aktiv.json()

`reentryDays: 300` lässt denselben Gast im nächsten Jahr wieder starten, verhindert aber einen zweiten Gruss im selben Jahr. Die Sitzung trägt die Bearer-Kopfzeile.

TypeScript — alle aktiven Automatisierungen pausieren

TypeScript

1export async function allesPausieren(token: string): Promise<number> {2    const kopf = { Authorization: 'Bearer ' + token }3    const liste = await fetch('https://tactictable.com/api/v1/marketing/flows?status=ACTIVE&limit=200', { headers: kopf })4    if (!liste.ok) throw new Error('HTTP ' + liste.status)5    const { data } = (await liste.json()) as { data: Array<{ id: string }> }6    for (const flow of data) {7        const antwort = await fetch('https://tactictable.com/api/v1/marketing/flows/' + encodeURIComponent(flow.id) + '/pause', { method: 'POST', headers: kopf })8        if (!antwort.ok) throw new Error('HTTP ' + antwort.status)9    }10    return data.length11}

Pausieren braucht keine Handlung — es hält Werbung an. Laufende Durchläufe warten, bis wieder aktiviert wird.