> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dexnotify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Automatisations

> Un parcours qui se déroule seul à l’entrée d’un contact dans une liste.

Une automatisation suit chaque contact qui **rejoint une liste** : une série d’étapes — attendre, envoyer un e-mail, envoyer un SMS — jouée pour lui seul. Une séquence de bienvenue, une relance après une inscription, un rappel.

```bash theme={null}
curl -X POST https://api.dexnotify.com/api/v1/automations \
  -H "x-api-key: $DEXNOTIFY_CLE" -H "content-type: application/json" \
  -d '{
    "name": "Bienvenue",
    "trigger": { "kind": "list_joined", "listId": "6702…" },
    "steps": [
      { "kind": "email", "templateId": "6720…", "subject": "Bienvenue {{prenom|}} !",
        "fromName": "Votre Marque", "fromEmail": "bonjour@votremarque.sn" },
      { "kind": "wait", "minutes": 4320 },
      { "kind": "sms", "sender": "MAMARQUE", "text": "Bonjour {{nom}}, -10 % sur votre première commande avec le code BIENVENUE." }
    ]
  }'
```

| Étape | Champs |
| - | - |
| `wait` | `minutes`, de 1 à 129 600 (90 jours) |
| `email` | `templateId` (un [modèle e-mail](#modeles-e-mail)), `subject`, `fromName`, `fromEmail` |
| `sms` | `sender`, `text` (1 600 caractères au plus) |

Un parcours a de 1 à 20 étapes, dont au moins un envoi.

## Activer, mettre en pause

Un parcours naît en `draft`. Il s’active par `PATCH /api/v1/automations/{id}` avec `{ "status": "active" }`, et se met en pause avec `"paused"`.

* Seuls les contacts qui rejoignent la liste **après** l’activation entrent dans le parcours.
* Un contact désinscrit d’un canal saute les envois de ce canal.
* `GET /api/v1/automations/{id}/runs` montre où en est chaque contact.

Un parcours actif ne se supprime pas : mettez-le d’abord en pause.

## Modèles e-mail

Les étapes e-mail s’appuient sur les modèles du projet, composés dans l’éditeur visuel du dashboard (**Contenus › Modèles e-mail**) ou par l’API :

| Route | Effet |
| - | - |
| `POST /api/v1/email-templates` | enregistre un modèle : `name`, `subject` (facultatif), `html` |
| `GET /api/v1/email-templates` | les modèles du projet |
| `PATCH /api/v1/email-templates/{id}` | modifie un modèle |
| `DELETE /api/v1/email-templates/{id}` | supprime un modèle ; les campagnes déjà composées gardent leur contenu |

Portées : `template:read`, `template:write`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.