Automatisations

Les automatisations vous permettent de créer des séquences d'e-mails en plusieurs étapes déclenchées par des événements d'abonnés. Définissez un déclencheur, construisez une séquence d'étapes, et MailLand exécute le flux automatiquement chaque fois que le déclencheur se déclenche.

Déclencheurs d'automatisationCopier le lien de la section

Chaque automatisation commence par un seul déclencheur :

| Manual | 5 | Déclenché manuellement via l'API |

Statuts d'automatisationCopier le lien de la section

Types d'étapesCopier le lien de la section

Chaque automatisation contient une séquence ordonnée d'étapes :

PersonnalisationCopier le lien de la section

Les étapes d'e-mail d'automatisation prennent en charge les balises de fusion {{variable}}, substituées par destinataire à partir du propre enregistrement de l'abonné inscrit.

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

Les anciennes orthographes en snake_case ({{first_name}}, {{last_name}}, {{full_name}}, {{subscriber_id}}) continuent de fonctionner comme alias.

Créer une automatisationCopier le lien de la section

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"
    }
  ]
}

Il n'existe pas de champ segmentId sur une automatisation : ce champ n'existe pas ici (les segments sont utilisés ailleurs, par exemple dans les campagnes). Le contenu d'une étape SendEmail provient de templateId, et non d'un htmlContent/textContent/fromName/fromEmail en ligne.

Champs des étapesCopier le lien de la section

Étape SendEmail (type : 0) :

Il n'existe pas de htmlContent/textContent/fromName/fromEmail/replyTo en ligne sur une étape. L'expéditeur est fixé à noreply@<premier domaine entièrement vérifié>, affiché avec le nom de l'espace de travail, non configurable par étape.

Étape Wait (type : 1) :

Étape Condition (type : 2) :

Une étape Condition est une porte, pas un embranchement : une liste d'étapes linéaire n'a pas de second chemin. Quand elle évalue vrai, l'inscription continue vers l'étape suivante. Quand elle évalue faux, l'inscription se termine là (Completed) et aucune étape ultérieure ne s'exécute pour cet abonné.

Les comparaisons sont des comparaisons de chaînes insensibles à la casse, les mêmes opérateurs déjà proposés par les segments. 400 VALIDATION_FAILED est renvoyé à la création/mise à jour lorsque conditionField est inconnu, que conditionOperator n'est pas l'une des valeurs ci-dessus, ou que conditionValue manque pour un opérateur qui en a besoin.

Étapes AddToList / RemoveFromList (type : 3, 4) :

Étape UpdateSubscriber (type : 5) :

Étape Webhook (type : 6) :

Les requêtes des étapes Webhook sont signées avec un secret du récepteur de l’étape (X-MLND-Signature, vérifié comme un webhook client) : chaque URL d’étape distincte a son propre secret, si bien qu’aucun récepteur ne peut signer pour un autre. Lisez-les avec GET /v1/marketing/automations/{id}/webhook-signing-secrets et renouvelez-les avec POST /v1/marketing/automations/{id}/webhook-signing-secrets/regenerate, voir Versionnage. Envoyez { "webhookUrl": "…" } pour ne renouveler qu’un seul récepteur.

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"
      }
    ]
  }'

RéponseCopier le lien de la section

{
  "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"
}

Il n'existe pas de champ segmentId/segmentName sur une automatisation, et les compteurs d'inscription sont totalEnrolled/totalCompleted (et non totalEnrollments/activeEnrollments/completedEnrollments). La réponse détaillée ajoute aussi steps (la liste complète des étapes), completionRate et totalFailed : les inscriptions ayant atteint une étape SendEmail sans modèle dans le tenant (absent ou supprimé depuis).

Lister les automatisationsCopier le lien de la section

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

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

Détails d'une automatisationCopier le lien de la section

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

Retourne l'automatisation complète incluant toutes les étapes :

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"
}

Mettre à jour une automatisationCopier le lien de la section

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

N'importe quel statut sauf Active peut être mis à jour (pas seulement Draft/Paused). Le corps de la requête est identique à celui de la création.

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"
      }
    ]
  }'

Activer une automatisationCopier le lien de la section

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

Fait passer l'automatisation de Draft ou Paused à Active. Une fois active, l'automatisation commence à inscrire les abonnés lorsque le déclencheur se déclenche.

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

Mettre en pause une automatisationCopier le lien de la section

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

Met l'automatisation en pause. Aucun nouvel abonné n'est inscrit, et les abonnés déjà dans la séquence n'avancent plus : chaque inscription s'arrête à son étape actuelle. Réactiver l'automatisation reprend chaque inscription arrêtée là où elle en était, en livrant tout ce qui était dû pendant la pause.

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

Archiver une automatisationCopier le lien de la section

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

Archive l'automatisation, ce qui peut être fait depuis n'importe quel statut, y compris Active. Les automatisations archivées sont masquées des vues de liste par défaut.

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

Dupliquer une automatisationCopier le lien de la section

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

Crée une nouvelle automatisation en Draft avec les étapes et paramètres clonés. Le paramètre de requête name est optionnel.

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

Déclencher manuellementCopier le lien de la section

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

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

Inscrit manuellement des abonnés spécifiques dans l'automatisation. L'automatisation doit être Active et son type de déclencheur doit être Manual (5).

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"]}'

Suivi des inscriptionsCopier le lien de la section

La progression de chaque abonné à travers l'automatisation est suivie comme une inscription :

Il n'existe pas de statut d'inscription Cancelled. La réponse des détails de l'automatisation inclut les compteurs agrégés d'inscriptions sous forme de totalEnrolled et totalCompleted (et non totalEnrollments/activeEnrollments/completedEnrollments/failedEnrollments).

Supprimer une automatisationCopier le lien de la section

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

Supprime définitivement l'automatisation, ses étapes et les données d'inscription.

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

Réponses d'erreurCopier le lien de la section

Les endpoints d'automatisations ne renvoient jamais 422.

Prochaines étapesCopier le lien de la section

• Campagnes : envoyer des campagnes ponctuelles
• Abonnés : gérer les contacts ciblés par les automatisations
• Listes : organiser les abonnés en listes pour les déclencheurs