Zur Dokumentation springen
API

Eine Automatisierung veröffentlichen

Friert den Entwurf als nächste Version ein und schaltet die Automatisierung ein. Personen treten ab diesem Moment ein, und wer den Auslöser früher erfüllt hat, wird nicht aufgenommen.

POST/automations/{id}/publish

Führt den echten Aufruf in Ihrem Workspace aus.

POST /automations/{id}/publish

Friert den Entwurf als nächste Version ein und schaltet die Automatisierung ein. Personen treten ab diesem Moment ein, und wer den Auslöser früher erfüllt hat, wird nicht aufgenommen.

Beispiel

Erfordert automations:write und emails:send.

curl
curl -X POST "$OE/automations/aut_7c2e9a1f4b8d30c65e1a9f27/publish" -H "$AUTH"
Antwort
{  "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": []}

Ein Entwurf mit einem blockierenden Problem wird mit 422 invalid_automation abgelehnt, und die Antwort listet jedes Problem in error.problems auf.

Jeder E-Mail-Schritt braucht eine veröffentlichte Vorlage mit einem Abmeldelink und einen Absender, als der dieser Schlüssel oder diese App senden darf. Eine Vorlage, die sich ohne den Namen eines Kontakts nicht füllen lässt, ist ebenfalls ein Problem, denn viele Kontakte haben keinen Namen: Geben Sie dem Wert einen Ersatzwert.

Veröffentlichen, wenn alle aktiven Automatisierungen des Tarifs belegt sind, antwortet mit 403 automation_limit_reached.

Einen unveränderten Entwurf erneut zu veröffentlichen erzeugt keine neue Version. Es schaltet aber eine pausierte Automatisierung wieder ein.

Referenz