Belgelere geç
API

Otomasyon oluşturma

Bir `definition` değerinden, bir `starter` değerinden ya da ikisini de göndermediğinizde boş bir taslak oluşturur ve otomasyonun tamamını döndürür. Siz yayımlayana dek hiçbir şey çalışmaz.

POST/automations

Gerçek çağrıyı çalışma alanınızda çalıştırır.

POST /automations

Bir definition değerinden, bir starter değerinden ya da ikisini de göndermediğinizde boş bir taslak oluşturur ve otomasyonun tamamını döndürür. Siz yayımlayana dek hiçbir şey çalışmaz.

Örnek

automations:write gerektirir.

curl
curl -X POST "$OE/automations" -H "$AUTH" -H 'content-type: application/json' -d '{  "name": "Welcome series",  "starter": "welcome-series",  "settings": { "timezone": "Europe/London" }}'
Yanıt
{  "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": []}

Bir taslak yarım olabilir. Eksik olan her şey problems içinde döner ve yalnızca yayımlama eksiksiz bir tanım ister.

Yapının kendisini bozan bir tanım, örneğin aynı anahtara sahip iki adım ya da iki yerden ulaşılan bir adım, 422 invalid_automation ile reddedilir.

settings ayarların herhangi bir alt kümesini alır, geri kalanlar varsayılanlarını korur. timezone varsayılan olarak UTC olur.

Bir çalışma alanı varsayılan olarak 100 otomasyon tutar. Sonraki, 422 workspace_limit_reached ile reddedilir.

Referans