Der Startblock legt die Kriterien fest, die ein Kontakt erfüllen muss, um in den Workflow einzutreten. Sie bestimmen die Kriterien, indem Sie einen Auslösertyp auswählen und Ihre Zielgruppe konfigurieren.

1. Optionen für Workflow-Auslöser.
   • Ereignis "Abonnement": Workflow auslösen, wenn ein Kontakt eine, mehrere oder alle Kontaktlisten abonniert.
   • Aktualisierungsereignis für Kontakteigenschaften: Workflow auslösen, wenn eine Kontakteigenschaft aktualisiert wird.

   • Verhaltens-Trigger (OPEN/CLICK): Löst aus, wenn ein Kontakt eine E-Mail öffnet oder auf einen Link klickt — mit optionalen Filtern nach Kampagnen, Tags und Absendern.

     Ausführliche Informationen zu Verhaltens-Triggern finden Sie im Abschnitt „ Verhaltens-Trigger “ dieses Artikels.

   • Externes Ereignis (Webhook): Starten Sie einen Workflow, wenn Ihr System (Website, App, CRM usw.) über die API ein Ereignis an Mailjet sendet. Sie können einen oder mehrere Webhook-Qualifier („Ereignisnamen“) auswählen, um festzulegen, welche externen Ereignisse den Workflow starten können.

     

     Weitere Details zu Webhooks finden Sie im Abschnitt „ Externe Ereignisse (Webhooks) “ dieses Artikels.
2. Segmentieren Sie Ihr Publikum (optional)
   • Wählen Sie ein Segment aus Ihren vorhandenen Segmenten aus oder erstellen Sie eines.
   • Erstellen Sie einen benutzerdefinierten Filter: Segmentieren Sie Ihre Zielgruppe, indem Sie ein Segment erstellen, das nur innerhalb des Workflows verfügbar ist. Hinweis: Die benutzerdefinierten Filtersegmente sind nicht in Ihrer Segmentierungsliste oder beim Senden einer Kampagne verfügbar.

Beispiel für Startblockkonfigurationen:

• Der Kontakt hat sich in eine beliebige Kontaktliste eingetragen und befindet sich in Frankreich.
• Kontakte, die sich in die Kontaktliste eintragen "Newsletter".
• Kontakte, die entweder "Newsletter" oder "Werbung" abonniert haben und zu einem "Engagierte Nutzer" Segment gehören.
• Verhalten (OPEN): Kontakt öffnet eine E-Mail aus der Kampagne „Spring_Sale_2026“ oder „VIP_Offers“.
• Verhalten (CLICK): Kontakt klickt auf einen Link mit den Tags pricing oder upgrade in einer beliebigen Kampagne.
• Verhalten (OPEN + Absender): Kontakt öffnet eine E-Mail, die von news@mail.example.com oder offers@mail.example.com gesendet wurde.
• Verhalten (CLICK + Kampagnen + Tags): Kontakt klickt auf einen Link mit den Tags shoes oder sneakers in den Kampagnen „Summer_Catalog“ oder „Back_To_School“.
• Externes Ereignis (Webhook): Der Kontakt löst das externe Ereignis purchase_completed aus.

Sobald Sie Ihren Startblock konfiguriert haben, um festzulegen, welche Kriterien Ihre Zielgruppe erfüllen muss, um in den Workflow zu gelangen, können Sie mit der Gestaltung der Customer Journey beginnen.

Sendet automatisch eine vordefinierte E-Mail an Kontakte, sobald sie diese Phase des Workflows erreichen.

• Design bearbeiten: Passen Sie den Inhalt Ihrer E-Mail-Vorlage an.
• Kampagnenname: Geben Sie einen Namen ein, um Ihre Kampagne zu identifizieren.
• Daten aus dem Webhook: Mit der Option Daten vom Webhook verwenden kann der Block E-Mail senden Daten verwenden, die über einen eingehenden Webhook oder ein externes Ereignis empfangen wurden. Dadurch kann die E-Mail mit den im Webhook-Payload gesendeten Werten personalisiert werden und nicht nur mit den standardmäßigen Kontakteigenschaften.

👉Beispiel: Daten aus einem Webhook verwenden

Stellen Sie sich vor, Sie betreiben einen Onlineshop. Jedes Mal, wenn ein Kunde einen Kauf abschließt, sendet Ihre Website eine HTTP-POST-Anfrage an den Webhook-Endpunkt von Mailjet Workflows. Dieses Ereignis löst anschließend die entsprechende Aktion in Ihrem Automatisierungs-Workflow aus.

Der Webhook sendet beispielsweise folgende Daten:

{
    "Tag": "purchase_completed",
    "contactMail": "localpart@domainpart.tld",
    "Data": {
        "Variables": {
            "firstname": "John",
            "product_name": "Running Shoes",
            "order_number": "ORD-45821",
            "delivery_date": "25 June",
            "discount_code": "THANKYOU10"
        }
    }
}

Ihre Automation könnte wie folgt aussehen:

Externes Ereignis/Webhook empfangen → E-Mail senden

Aktivieren Sie im Block E-Mail senden die Option Daten vom Webhook verwenden.

Im Inhalt des Blocks „E-Mail senden“ können Sie anschließend die Templating Language von Mailjet verwenden (https://documentation.mailjet.com/hc/de/articles/16886347025947-Mailjet-Templating-Language). Verwenden Sie insbesondere Variablen vom Typ var. Die jeweiligen Ersatzwerte werden über Ihren Aufruf an https://api.mailjet.com/V3/REST/workflow2/event übermittelt:

Hallo {{var:firstname:""}},
vielen Dank für Ihre Bestellung {{var:order_number:""}}.
Sie haben Folgendes gekauft: {{var:product_name:"Ihr Artikel"}}
Ihr voraussichtliches Lieferdatum ist der {{var:delivery_date:"demnächst"}}.
Hier ist ein Rabattcode für Ihre nächste Bestellung: {{var:discount_code:""}}

Der Empfänger würde Folgendes erhalten:

Hallo John,
vielen Dank für Ihre Bestellung ORD-45821.
Sie haben Folgendes gekauft: Running Shoes.
Ihr voraussichtliches Lieferdatum ist der 25 June.
Hier ist ein Rabattcode für Ihre nächste Bestellung: THANKYOU10

Ohne die Option Daten vom Webhook verwenden würde die E-Mail nur reguläre Kontaktdaten verwenden, die bereits in Mailjet gespeichert sind, beispielsweise Kontakteigenschaften, die über Variablen vom Typ data und nicht über Variablen vom Typ var abgerufen werden können. Temporäre Werte aus dem Webhook, wie Bestellnummer, Produktname oder Rabattcode, könnten nicht verwendet werden.

👉Endpunktdefinition

Webhook-Ereignisse werden an den folgenden Endpunkt gesendet:

POST /v3/REST/workflow2/event

Payload-Felder

Wenn das Objekt Data im Ereignis-Payload enthalten ist, werden die Daten vorübergehend im Workflow-Status des Kontakts gespeichert. Sie können anschließend von einem späteren Block E-Mail senden im selben Workflow verwendet werden.

Diese Daten werden aus dem Workflow-Status entfernt, sobald sie verwendet wurden oder der Kontakt den Workflow verlässt.

Verfügbare Felder im Data-Objekt

Das Objekt Data kann Felder enthalten, die von der Send API von Mailjet unterstützt werden.

Beispiel-Payload

{ 
  "ContactMail": "john@example.com", 
  "Tag": "purchase_completed", 
  "Data": { 
    "Variables": { 
      "firstname": "John", 
      "product_name": "Running Shoes", 
      "order_number": "ORD-45821", 
      "delivery_date": "25 June", 
      "discount_code": "THANKYOU10"
    }, 
    "TrackOpens": "enabled", 
    "TrackClicks": "account_default", 
    "CustomID": "order-confirmation-ORD-45821" 
  } 
}

In diesem Beispiel:

• ContactMail identifiziert den Kontakt, der in den Workflow aufgenommen werden soll.
• Tag definiert den Ereignisnamen, mit dem der Workflow ausgelöst wird.
• Variables enthält temporäre Werte, die in einem späteren Block E-Mail senden verwendet werden können.
• TrackOpens aktiviert das Öffnungs-Tracking für diese Nachricht.
• TrackClicks verwendet die im Mailjet-Konto festgelegten Tracking-Einstellungen.
• CustomID fügt der Nachricht eine benutzerdefinierte Kennung hinzu.

Um die Werte aus dem Objekt Variables in der E-Mail zu verwenden, aktivieren Sie im Block E-Mail senden die Option Daten vom Webhook verwenden.

Anschließend können Sie diese Variablen in der E-Mail-Vorlage mithilfe der Templating Language von Mailjet referenzieren, zum Beispiel:

Hallo {{var:firstname:""}},
vielen Dank für Ihre Bestellung {{var:order_number:""}}.
Sie haben Folgendes gekauft: {{var:product_name:"Ihr Artikel"}}
Ihr voraussichtliches Lieferdatum ist der {{var:delivery_date:"demnächst"}}.
Hier ist Ihr Rabattcode: {{var:discount_code:""}}

Ermöglicht die Verwaltung Ihrer Kontakte innerhalb bestimmter Listen.

• Abonnieren einer Liste: Fügt den Kontakt zu einer ausgewählten Liste hinzu und abonniert ihn.
• Hinzufügen zu einer Liste und erneutes Abonnieren: Fügt den Kontakt hinzu und meldet ihn erneut an, falls er bereits vorhanden ist.
• Zu einer Liste hinzufügen, ohne sich anzumelden: Fügt den Kontakt hinzu, ohne den Abonnementstatus zu ändern.
• Abmelden von einer Liste: Entfernt das Abonnement von Kontakten aus der ausgewählten Liste.
• Aus einer Liste löschen: Entfernt den Kontakt vollständig aus der ausgewählten Liste.

Ermöglicht die Aktualisierung der vorhandenen Eigenschaften Ihrer Kontakte:

• Wählen Sie die Kontakteigenschaft, die Sie aktualisieren möchten, aus den verfügbaren Eigenschaften aus (z. B. Alter, Stadt, Geburtstag).
• Definieren Sie den neuen Wert, der angewendet werden soll.

Wenn Sie den Bedingungsblock verwenden, können Sie den Kontakt anhand von Kriterien auswerten, um zu bestimmen, welchen Weg er im Workflow einschlagen soll, indem Sie ein Segment auswählen.

• Die Kriterien für die Bedingung werden durch Segmente oder benutzerdefinierte Filter festgelegt
• Kontakte, die keine der Bedingungen erfüllen, werden über einen standardmäßigen "Fallback-Pfad" geleitet.

Beispiel:

Es kann eine Bedingung angewendet werden, um festzustellen, ob der Kontakt kürzlich mit einer E-Mail interagiert hat, indem ein Filter mit "Hat eine E-Mail in den letzten X Tagen geöffnet" erstellt wird. Wenn der Empfänger eine innerhalb der letzten X Tage gesendete E-Mail geöffnet hat, wird er den Workflow verlassen. Wenn Empfänger noch keine E-Mail geöffnet haben, erhalten sie eine neue E-Mail.

Der Ereignisblock wartet, bis ein Ereignis eingetreten ist, bevor sich der Kontakt im Arbeitsablauf weiterbewegt. Um den Ereignisblock zu konfigurieren, wählen Sie:

Ereignistypen

• Listen-Abonnement — zur Liste hinzugefügt/abonniert.
• Aktualisierung einer Kontakteigenschaft — ein Wert ändert sich.
• Verhalten: OPEN — der Kontakt öffnet eine E-Mail (kann gefiltert werden).

• Verhalten: CLICK — der Kontakt klickt auf einen Link (kann gefiltert werden).

  Ausführliche Informationen zu Verhaltens-Triggern finden Sie im Abschnitt „ Verhaltens-Trigger “ dieses Artikels.

• Externes Ereignis (Webhook) — der Workflow wird pausiert, bis Ihr System ein passendes externes Ereignis (Webhook-Qualifier) für diesen Kontakt sendet.
  

  Weitere Details zu Webhooks finden Sie im Abschnitt „ Externe Ereignisse (Webhooks) “ dieses Artikels.

Konfigurieren Sie den Fallback-Timer: Damit wird sichergestellt, dass ein Kontakt nie im Workflow stecken bleibt, weil das Ereignis nie eintritt.

Mit diesem Block können Sie festlegen, wann der Kontakt zum nächsten Schritt der Reise übergeht, indem Sie einen Verzögerungstimer, einen benutzerdefinierten Datumsfilter oder einen Timer für Datumseigenschaften einstellen.

• Mit dem Verzögerungstimer können Sie den nächsten Schritt im Arbeitsablauf um Minuten, Stunden oder Tage verzögern.
• Der benutzerdefinierte Datums-Timer verzögert den nächsten Schritt auf der Grundlage eines festgelegten Datums. Sobald Sie das Datum ausgewählt haben, legen Sie fest, ob es sich um ein einmaliges Ereignis handelt oder ob es jährlich/monatlich wiederkehrend sein soll.

• Mit dem Timer für Datumseigenschaften können Sie den nächsten Schritt auf der Grundlage des Datums einer Kontakteigenschaft verzögern. (z. B. Geburtstag).

Wenn Sie den Versandzeitpunkt der E-Mail genauer festlegen möchten, können Sie bei allen drei Timer-Typen angeben, zu welcher Tageszeit und an welchen Wochentagen die E-Mail versendet werden soll.

Der Ausstiegsblock stellt das Ende eines Workflows für einen Kontakt dar. Ein Workflow kann viele Ausstiegsblöcke für jeden im Workflow dargestellten Pfad haben, und mit jedem Ausstiegsblock können Sie festlegen, ob der Kontakt wieder in den Workflow aufgenommen werden soll, wenn er die Auslösekriterien des Startblocks erneut erfüllt.

👉 404 — Kontakt existiert nicht

Was Sie sehen

HTTP/2 404
content-type: application/json; charset=utf-8
{"Code":"","Message":"The requested resource does not exist","Status":404,"Details":null}

Bedeutung
Mailjet konnte den in Ihrer Anfrage referenzierten Kontakt nicht finden (z. B. ist die Kontakt-E-Mail in den Kontakten Ihres API-Schlüssels nicht vorhanden).

So beheben Sie das Problem

• Stellen Sie sicher, dass der Kontakt in Ihrer Mailjet-Audience existiert, bevor Sie das Ereignis senden.

• Prüfen Sie, ob Sie das richtige Konto / den richtigen API-Schlüssel verwenden (dort, wo der Kontakt gespeichert ist).

• Überprüfen Sie den in contactMail gesendeten Wert (Tippfehler, zusätzliche Leerzeichen, falsche Domain).

👉 204 — Mailjet hat Ihre Anfrage erfolgreich erhalten

Eine 204-Antwort bedeutet, Mailjet hat Ihre Anfrage erfolgreich erhalten, gibt aber keinen Response-Body zurück. Eine 204 zeigt nicht zuverlässig an, ob eine Workflow-Aktion ausgelöst wurde.

Was Sie sehen

HTTP/2 204

Bedeutung

A) Anfrage erhalten und Workflow-Aktion wurde ausgelöst

Das passiert, wenn das Ereignis genau dem entspricht, was der Workflow erwartet:

• der Kontakt existiert und kann über contactMail identifiziert werden

• der Webhook-Qualifikator (Tag) entspricht einem im Start- oder Ereignis-Block ausgewählten Qualifikator

• der Kontakt erfüllt alle zusätzlichen Start-/Ereignis-Block-Filter (Segmentzugehörigkeit, Bedingungen usw.)

Was zu tun ist

• Prüfen Sie den Workflow-Fortschritt des Kontakts in der Automations-UI (z. B. der Kontakt hat den Start-/Ereignis-Block passiert oder ist in den nächsten Schritt eingetreten).

• Wenn Ihr Workflow im nächsten Schritt eine E-Mail sendet, prüfen Sie, ob die Nachricht in der Nachrichtenhistorie/Aktivität des Kontakts erscheint.

B) Anfrage erhalten, aber keine Workflow-Aktion wurde ausgelöst

Eine 204 kann auch auftreten, wenn die Anfrage gültig ist, aber nicht übereinstimmt mit den Automationsbedingungen, z. B.:

• der Qualifikator (Tag) stimmt nicht mit den im Block ausgewählten Qualifikatoren überein

• der Kontakt entspricht nicht den Workflow-Filtern (Segment/Bedingungen)

• der Kontakt ist aufgrund der Workflow-Einstellungen nicht berechtigt, den Workflow zu betreten/erneut zu betreten (z. B. „Kontakte können nicht erneut eintreten“)

• der Kontakt wartet aktuell nicht auf den spezifischen Ereignis-Block, den Sie erfüllen wollten

Was zu tun ist

• Prüfen Sie, ob Schreibweise/Groß- und Kleinschreibung des Qualifikators exakt mit der Konfiguration im Builder übereinstimmt.

• Stellen Sie sicher, dass der Kontakt dem Segment/den Filtern im Start-/Ereignis-Block entspricht.

• Prüfen Sie die Eintrittsregeln (Wiedereintritt) und wo sich der Kontakt aktuell im Workflow befindet.

Empfehlung: 204 als „akzeptiert“ behandeln und das Ergebnis in der UI verifizieren

Da 204 beide oben genannten Ergebnisse bedeuten kann, behandeln Sie sie als „Anfrage akzeptiert“ und bestätigen Sie das Ergebnis, indem Sie Folgendes prüfen:

• die Position/den Fortschritt des Kontakts im Workflow

Ergebnis einer 204 per API verifizieren (Messages Endpoint)

Da 204 No Content nur bestätigt, dass die Anfrage akzeptiert wurde (und keinen Response-Body enthält), können Sie prüfen, ob der Workflow tatsächlich eine E-Mail gesendet hat, indem Sie Mailjets Ressource Messages für diesen Kontakt innerhalb eines definierten Zeitfensters abfragen.  (Weitere Details finden Sie in unserer Developer-Dokumentation hier.)

1) Nachrichten an einen bestimmten Kontakt abfragen

Verwenden Sie die ContactID des Kontakts und einen Start-Timestamp:

GET https://api.mailjet.com/v3/REST/message?Contact=$ContactID&FromTS=2026-01-19T00:00:00

So interpretieren Sie das Ergebnis

• Nachrichten vorhanden (Count > 0 / Data-Array enthält Einträge): der Workflow hat innerhalb des angefragten Zeitraums einen E-Mail-Versand für diesen Kontakt ausgelöst.

• Keine Nachrichten (Count = 0 / leeres Data): entweder wurde in diesem Zeitraum keine E-Mail gesendet, oder Sie müssen das Zeitfenster erweitern (oder die richtige ContactID/das richtige Konto verifizieren).

Best Practices

• Verwenden Sie beim Testen ein ausreichend großes FromTS-Zeitfenster (z. B. 15–60 Minuten vor dem Testaufruf beginnen).

• Nutzen Sie in Logs und Timestamps eine konsistente Zeitzone (UTC empfohlen).

2) Wenn Sie die ContactID nicht haben

Wenn Ihr System nur die E-Mail-Adresse hat, rufen Sie zuerst die ContactID ab (über die Contacts-Ressourcen) und rufen Sie anschließend den Messages-Endpoint mit dem Filter Contact auf. Weitere Informationen finden Sie hier.

3) Was das bestätigt (und was nicht)

Diese Prüfung bestätigt, dass für diesen Kontakt in dem Zeitfenster ein Message-Objekt existiert. Sie beweist jedoch nicht, welcher Block es ausgelöst hat. Kombinieren Sie dies beim Troubleshooting mit:

• dem Workflow-Fortschritt in der UI (Kontaktposition im Workflow), und/oder

• Ihren System-Logs (Timestamp + gesendeter Qualifikator/Tag + Request GUID).

👉 400 — Ungültiger Tag (nicht unterstützte Zeichen, z. B. „- “)

Was Sie sehen

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid Tag: should contain only alphanumeric ASCII characters and underscores","Status":400,"Details":null}

Bedeutung
Der Webhook-Qualifikator (Tag) enthält ungültige Zeichen. Tags dürfen nur alphanumerische ASCII-Zeichen und Unterstriche enthalten (z. B. purchase_completed). Bindestriche (-) sind nicht erlaubt.

So beheben Sie das Problem

• Ersetzen Sie Bindestriche durch Unterstriche:

  • purchase-completed → purchase_completed

• Standardisieren Sie eine Namenskonvention für Qualifikatoren in Ihren Systemen (empfohlen: Kleinbuchstaben + Unterstriche).

👉 400 — Ungültige Payload-Struktur (Tag wird als Array gesendet)

Was Sie sehen

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"error casting payload into associated model","Status":400,"Details":null}

Bedeutung
Der Request Body entspricht nicht dem erwarteten Schema. Tag muss ein einzelner String sein, nicht ein Array.

So beheben Sie das Problem

• Senden Sie einen Qualifikator pro Anfrage (einen Tag-Wert).

• Wenn Sie mehrere Qualifikatoren auslösen müssen, senden Sie mehrere API-Aufrufe — einen pro Qualifikator.

👉 400 — Ungültiges ContactMail (ungültiges E-Mail-Format)

Was Sie sehen

HTTP/2 400
content-type: application/json; charset=utf-8
{"Code":"MJ-0001","Message":"invalid ContactMail: mail: missing '@' or angle-addr","Status":400,"Details":null}

Bedeutung
contactMail ist kein gültiges E-Mail-Format (z. B. fehlt @).

So beheben Sie das Problem

• Validieren Sie E-Mail-Adressen in Ihrem System, bevor Sie den Endpoint aufrufen.

• Stellen Sie sicher, dass Sie eine reine E-Mail-Adresse senden (keine Anzeigeformatierung), z. B.:

  • Gültig: user@example.com

  • Ungültig: John Doe <user@example.com>

Mit dem Automatisierungs-Builder von Mailjet können Sie ganz einfach Workflows erstellen, die an wiederkehrenden Daten ausgelöst werden – ideal für Geburtstage, Mitgliedschaftsjubiläen oder Verlängerungserinnerungen.

Hier ist ein Schritt-für-Schritt-Beispiel zur Einrichtung eines Geburtstags-Mail-Workflows:

Übersicht über die Workflow-Struktur

Der Workflow besteht aus drei Hauptschritten:

1. Auslöser: Wenn das Geburtsdatum des Kontakts aktualisiert wird.
2. Timer: Warten bis zum nächsten jährlichen Ereignis.
3. Aktion: Versand einer Geburtstags-E-Mail.

1. Auslöser definieren (Kontakt-Eigenschaft wird aktualisiert)

Erstellen Sie einen neuen Workflow und wählen Sie den Auslöser „Kontakteigenschaft-Aktualisierung“.

• Setzen Sie den Eigenschaftsfilter auf Geburtstag (Datums-/Uhrzeitfeld).
• Wenden Sie ein Segment an: Fügen Sie die Bedingung "Ist in Liste" hinzu und wählen Sie die gewünschte Kontaktliste (z. B. MyFirstTest).

2. Timer hinzufügen (Warten bis zum nächsten Ereignis)

Fügen Sie einen Timer-Block nach dem Auslöser hinzu.

• Wählen Sie die Eigenschaft Geburtstag aus.
• Stellen Sie auf „Nächsten jährlichen aktivierung“.

• Optional: Legen Sie eine Uhrzeit, bestimmte Wochentage oder eine Verzögerung fest.

3. E-Mail konfigurieren (E-Mail senden)

Fügen Sie nach dem Timer einen „E-Mail senden“-Block hinzu.

• Erstellen Sie Ihre Geburtstags-E-Mail-Vorlage.
• Beispiel-Betreff: “🎂 Alles Gute zum Geburtstag von uns allen!”

4. Jährliche Wiederholung aktivieren

Verbinden Sie das Ende des Workflows wieder mit dem Timer, damit der Ablauf jedes Jahr am Geburtstag des Kontakts wiederholt wird.

📝 Tipps

• Führen Sie Tests mit Testkontakten durch, um den Ablauf zu überprüfen.
• Sie können dieses Setup auch für andere wiederkehrende Ereignisse wie Jubiläen, Verlängerungserinnerungen oder Treueaktionen verwenden.