Automatisierungen

Mit Automatisierungen können Sie mehrstufige E-Mail-Sequenzen erstellen, die durch Abonnenten-Events ausgelöst werden. Definieren Sie einen Trigger, erstellen Sie eine Abfolge von Schritten, und MailLand führt den Ablauf automatisch aus, sobald der Trigger auslöst.

Automatisierungs-TriggerLink zum Abschnitt kopieren

Jede Automatisierung beginnt mit einem einzelnen Trigger:

| Manual | 5 | Manuell über API ausgelöst |

AutomatisierungsstatusLink zum Abschnitt kopieren

SchritttypenLink zum Abschnitt kopieren

Jede Automatisierung enthält eine geordnete Abfolge von Schritten:

PersonalisierungLink zum Abschnitt kopieren

Automatisierungs-E-Mail-Schritte unterstützen {{variable}}-Merge-Tags, die pro Empfänger durch den Datensatz des eingeschriebenen Abonnenten ersetzt werden.

<p>Hi {{firstName}}, here's what's new this month.</p>

Die älteren Snake-Case-Schreibweisen ({{first_name}}, {{last_name}}, {{full_name}}, {{subscriber_id}}) funktionieren weiterhin als Aliase.

Automatisierung erstellenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations

{
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": 0,
  "mailingListId": "7h3n5k8w2q9m1t",
  "campaignId": null,
  "steps": [
    {
      "type": 0,
      "order": 1,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!"
    },
    {
      "type": 1,
      "order": 2,
      "delayMinutes": 1440
    },
    {
      "type": 0,
      "order": 3,
      "templateId": "9k4p2x7m1q3n8z"
    }
  ]
}

Es gibt kein segmentId-Feld bei einer Automatisierung: dieses Feld existiert hier nicht (Segmente werden anderswo verwendet, z. B. bei Kampagnen). Der Inhalt eines SendEmail-Schritts stammt aus templateId, nicht aus inline htmlContent/textContent/fromName/fromEmail.

SchrittfelderLink zum Abschnitt kopieren

SendEmail-Schritt (type: 0):

Es gibt keinen inline htmlContent/textContent/fromName/fromEmail/replyTo bei einem Schritt. Der Absender ist fest auf noreply@<erste vollständig verifizierte Domain> eingestellt und wird mit dem Workspace-Namen angezeigt, nicht pro Schritt konfigurierbar.

Wait-Schritt (type: 1):

Condition-Schritt (type: 2):

Ein Condition-Schritt ist ein Gate, keine Verzweigung: Eine lineare Schrittliste hat keinen zweiten Pfad. Bei wahr fährt die Einschreibung mit dem nächsten Schritt fort. Bei falsch endet die Einschreibung dort (Completed), und kein späterer Schritt läuft für diesen Abonnenten.

Vergleiche erfolgen als case-insensitive String-Vergleiche, dieselben Operatoren, die Segmente bereits anbieten. 400 VALIDATION_FAILED wird bei Erstellung/Aktualisierung zurückgegeben, wenn conditionField unbekannt ist, conditionOperator keiner der obigen Werte ist, oder conditionValue bei einem Operator fehlt, der einen Wert benötigt.

AddToList- / RemoveFromList-Schritte (type: 3, 4):

UpdateSubscriber-Schritt (type: 5):

Webhook-Schritt (type: 6):

Anfragen von Webhook-Schritten werden mit einem Geheimnis des Empfängers des Schritts signiert (X-MLND-Signature, Prüfung wie bei Kunden-Webhooks): Jede eigene Schritt-URL hat ihr eigenes Geheimnis, sodass kein Empfänger für einen anderen signieren kann. Lesen Sie die Geheimnisse mit GET /v1/marketing/automations/{id}/webhook-signing-secrets und erneuern Sie sie mit POST /v1/marketing/automations/{id}/webhook-signing-secrets/regenerate, siehe Versionierung. Senden Sie { "webhookUrl": "…" }, um nur einen Empfänger zu rotieren.

curl -X POST https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

AntwortLink zum Abschnitt kopieren

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "draft",
  "statusName": "Draft",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 0,
  "totalCompleted": 0,
  "activatedAt": null,
  "createdAt": "2026-02-17T12:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Es gibt kein segmentId/segmentName-Feld bei einer Automatisierung, und die Aufnahmezähler heißen totalEnrolled/totalCompleted (nicht totalEnrollments/activeEnrollments/completedEnrollments). Die Detailantwort fügt außerdem steps (die vollständige Schrittliste), completionRate und totalFailed hinzu: Einschreibungen, die einen SendEmail-Schritt ohne Vorlage im Tenant erreicht haben (fehlend oder inzwischen gelöscht).

Automatisierungen auflistenLink zum Abschnitt kopieren

GET https://api.mail.land/v1/marketing/automations

curl https://api.mail.land/v1/marketing/automations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Automatisierungsdetails abrufenLink zum Abschnitt kopieren

GET https://api.mail.land/v1/marketing/automations/{id}

Gibt die vollständige Automatisierung einschließlich aller Schritte zurück:

curl https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "id": "4f8k2m9p1q6z3s",
  "name": "Welcome Series",
  "description": "3-email welcome sequence for new subscribers",
  "trigger": "subscriberJoins",
  "triggerName": "SubscriberJoins",
  "status": "active",
  "statusName": "Active",
  "mailingListId": "7h3n5k8w2q9m1t",
  "mailingListName": "Product Updates",
  "campaignId": null,
  "campaignName": null,
  "stepsCount": 3,
  "totalEnrolled": 230,
  "totalCompleted": 200,
  "totalFailed": 4,
  "activatedAt": "2026-01-10T08:05:00Z",
  "steps": [
    {
      "order": 1,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "2p9x4k7m3q8n1z",
      "subject": "Welcome to our newsletter!",
      "settings": null
    },
    {
      "order": 2,
      "type": "wait",
      "typeName": "Wait",
      "delayMinutes": 1440,
      "templateId": null,
      "subject": null,
      "settings": null
    },
    {
      "order": 3,
      "type": "sendEmail",
      "typeName": "SendEmail",
      "delayMinutes": null,
      "templateId": "9k4p2x7m1q3n8z",
      "subject": "Getting started with MailLand",
      "settings": null
    }
  ],
  "completionRate": 86.96,
  "createdAt": "2026-01-10T08:00:00Z",
  "updatedAt": "2026-02-17T12:00:00Z"
}

Automatisierung aktualisierenLink zum Abschnitt kopieren

PUT https://api.mail.land/v1/marketing/automations/{id}

Jeder Status außer Active kann aktualisiert werden (nicht nur Draft/Paused). Der Anfragekörper entspricht der Erstellungsanfrage.

curl -X PUT https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": 0,
    "mailingListId": "7h3n5k8w2q9m1t",
    "steps": [
      {
        "type": 0, "order": 1,
        "subject": "Welcome!",
        "templateId": "2p9x4k7m3q8n1z"
      },
      { "type": 1, "order": 2, "delayMinutes": 1440 },
      {
        "type": 0, "order": 3,
        "subject": "Getting started",
        "templateId": "9k4p2x7m1q3n8z"
      }
    ]
  }'

Automatisierung aktivierenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations/{id}/activate

Überführt die Automatisierung von Draft oder Paused in den Status Active. Sobald sie aktiv ist, beginnt die Automatisierung mit der Aufnahme von Abonnenten, wenn der Trigger auslöst.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/activate \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Automatisierung pausierenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations/{id}/pause

Pausiert die Automatisierung. Es werden keine neuen Abonnenten aufgenommen, und Abonnenten, die sich bereits in der Sequenz befinden, kommen nicht weiter: jede Einschreibung hält an ihrem aktuellen Schritt an. Erneutes Aktivieren der Automatisierung setzt jede angehaltene Einschreibung dort fort, wo sie stand, und liefert alles nach, was während der Pause fällig wurde.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/pause \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Automatisierung archivierenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations/{id}/archive

Archiviert die Automatisierung, was aus jedem Status heraus möglich ist, einschließlich Active. Archivierte Automatisierungen werden in Standardlistenansichten ausgeblendet.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/archive \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Automatisierung duplizierenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations/{id}/duplicate?name=Copy%20of%20Welcome%20Series

Erstellt eine neue Draft-Automatisierung mit kopierten Schritten und Einstellungen. Der Abfrageparameter name ist optional.

curl -X POST "https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/duplicate?name=Copy%20of%20Welcome%20Series" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Manuell auslösenLink zum Abschnitt kopieren

POST https://api.mail.land/v1/marketing/automations/{id}/trigger

{
  "subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]
}

Nehmen Sie bestimmte Abonnenten manuell in die Automatisierung auf. Die Automatisierung muss den Status Active haben und ihr Triggertyp muss Manual (5) sein.

curl -X POST https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s/trigger \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{"subscriberIds": ["3m8k1p9x4q7n2z", "6q2n9k4x1p8m3z", "1x7m3q8k2n9p4z"]}'

Aufnahme-TrackingLink zum Abschnitt kopieren

Der Fortschritt jedes Abonnenten durch die Automatisierung wird als Aufnahme verfolgt:

Es gibt keinen Aufnahmestatus Cancelled. Die Automatisierungsdetail-Antwort enthält aggregierte Aufnahmezahlen als totalEnrolled und totalCompleted (nicht totalEnrollments/activeEnrollments/completedEnrollments/failedEnrollments).

Automatisierung löschenLink zum Abschnitt kopieren

DELETE https://api.mail.land/v1/marketing/automations/{id}

Löscht die Automatisierung, ihre Schritte und Aufnahmedaten dauerhaft.

curl -X DELETE https://api.mail.land/v1/marketing/automations/4f8k2m9p1q6z3s \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

FehlerantwortenLink zum Abschnitt kopieren

Die Automatisierungs-Endpunkte geben nie 422 zurück.

Nächste SchritteLink zum Abschnitt kopieren

• Kampagnen: Einmalige Kampagnen versenden
• Abonnenten: Kontakte verwalten, die Automatisierungen ansprechen
• Listen: Abonnenten in Listen für Trigger organisieren