Créer une automatisation
Crée un brouillon à partir d'une `definition`, d'un `starter`, ou un brouillon vide quand vous n'envoyez ni l'un ni l'autre, et renvoie l'automatisation entière. Rien ne s'exécute tant que vous ne la publiez pas.
Exécute le véritable appel sur votre espace de travail.
POST /automations
Crée un brouillon à partir d'une definition, d'un starter, ou un brouillon vide quand vous n'envoyez ni l'un ni l'autre, et renvoie l'automatisation entière. Rien ne s'exécute tant que vous ne la publiez pas.
Exemple
Nécessite automations:write.
curl -X POST "$OE/automations" -H "$AUTH" -H 'content-type: application/json' -d '{ "name": "Welcome series", "starter": "welcome-series", "settings": { "timezone": "Europe/London" }}'{ "object": "automation", "id": "aut_7c2e9a1f4b8d30c65e1a9f27", "name": "Welcome series", "description": null, "status": "live", "triggerKind": "audience_joined", "stepCount": 4, "emailCount": 2, "hasUnpublishedChanges": false, "publishedVersion": 2, "pausedReason": null, "lastError": null, "counts": { "active": 38, "completed": 412, "exited": 9 }, "createdBy": "q7Vd3kX9mT2pLw8RzN4bYc6HfJ1sGa5E", "publishedAt": "2026-10-02T09:14:00.000Z", "pausedAt": null, "archivedAt": null, "createdAt": "2026-10-01T16:40:12.000Z", "updatedAt": "2026-10-02T09:14:00.000Z", "definition": { "trigger": { "kind": "audience_joined", "audienceId": "aud_4c1b8e2a7d9f05c36b4e8a71", "includeImported": false }, "entry": "welcome", "steps": [ { "key": "welcome", "kind": "send_email", "next": "pause", "templateId": "tpl_9c1f0a4b7e05d3862c1f0a44", "templateVersion": null, "from": { "email": "[email protected]", "name": "Acme" }, "replyTo": null, "subject": null, "props": { "firstName": { "source": "contact", "field": "firstName" } } }, { "key": "pause", "kind": "wait", "next": "opened", "wait": { "mode": "duration", "amount": 3, "unit": "days" } }, { "key": "opened", "kind": "branch", "condition": { "kind": "email_opened", "stepKey": "welcome" }, "yes": null, "no": "nudge" }, { "key": "nudge", "kind": "send_email", "next": null, "templateId": "tpl_8f3a1c2e9b7d4a60", "templateVersion": null, "from": { "email": "[email protected]", "name": "Acme" }, "replyTo": null, "subject": "{{firstName|Hello}}, did you see this?", "props": {} } ] }, "published": { "trigger": { "kind": "audience_joined", "…": "…" }, "entry": "welcome", "steps": ["…"] }, "settings": { "timezone": "Europe/London", "sendWindow": { "days": [1, 2, 3, 4, 5], "startMinute": 540, "endMinute": 1020 }, "reentryDays": null, "exitOnLeave": true, "listAudienceId": null }, "problems": []}Un brouillon peut être inachevé. Ce qui manque revient dans problems, et seule la publication exige une définition complète.
Une définition qui enfreint la structure elle-même, par exemple deux étapes avec la même clé ou une étape atteinte depuis deux endroits, est refusée avec 422 invalid_automation.
settings accepte n'importe quel sous-ensemble des paramètres, et les autres gardent leur valeur par défaut. timezone vaut UTC par défaut.
Un espace de travail peut contenir 100 automatisations par défaut. La suivante est refusée avec 422 workspace_limit_reached.