Ein Ereignis senden
Erfasst, dass ein Kontakt in Ihrem Produkt etwas getan hat. Das Ereignis startet jede aktive Automatisierung, deren Auslöser es nennt, und lässt alle weitergehen, die darauf gewartet haben.
Führt jeden der 2 Aufrufe in Ihrem Workspace aus.
POST /events
Erfasst, dass ein Kontakt in Ihrem Produkt etwas getan hat. Das Ereignis startet jede aktive Automatisierung, deren Auslöser es nennt, und lässt alle weitergehen, die darauf gewartet haben.
Beispiel
Erfordert contacts:write. Geben Sie den Kontakt mit email oder mit contactId an.
curl -X POST "$OE/events" -H "$AUTH" -H 'content-type: application/json' -H 'Idempotency-Key: order-A-1042' -d '{ "name": "order.placed", "email": "[email protected]", "properties": { "orderId": "A-1042", "total": 59 }, "createContact": true}'{ "object": "contact_event", "id": "cev_6a1d9f3c8b2e40a75d9c1e38", "contactId": "5b0e7c1a-2f4d-4c8b-9a36-1e7d0c5f8b24", "email": "[email protected]", "name": "order.placed", "properties": { "orderId": "A-1042", "total": 59 }, "occurredAt": "2026-10-11T08:02:03.000Z", "mode": "live", "createdAt": "2026-10-11T08:02:03.412Z", "replayed": false, "enrolled": ["aut_7c2e9a1f4b8d30c65e1a9f27"], "resumed": 0}name besteht aus bis zu 100 Buchstaben, Ziffern, Punkten, Doppelpunkten, Bindestrichen und Unterstrichen und beginnt mit einem Buchstaben oder einer Ziffer. Bei Namen wird Groß- und Kleinschreibung unterschieden.
properties fasst höchstens 50 Schlüssel und 4 KB JSON. Ein Filter des Auslösers, ein E-Mail-Wert und eine Verzweigung können sie lesen.
occurredAt ist standardmäßig jetzt. Es darf bis zu 90 Tage in der Vergangenheit und höchstens 5 Minuten in der Zukunft liegen.
Eine unbekannte Adresse antwortet mit 404 contact_not_found, sofern createContact nicht true ist. Dann wird der Kontakt angelegt, mit contactName als Namen.
enrolled listet die Automatisierungen auf, in die der Kontakt eingetreten ist, und resumed zählt die Wartezeiten, die das Ereignis beendet hat.
Denselben Idempotency-Key erneut zu senden antwortet mit 200, dem ersten Ereignis und replayed: true. Derselbe Schlüssel mit anderem Body wird mit 422 idempotency_key_reuse abgelehnt.
Ein mit einem Testschlüssel gesendetes Ereignis wird mit mode: "test" gespeichert und startet nichts.
Batch
POST /events/batch nimmt bis zu 100 Ereignisse in events, jedes aufgebaut wie der Body oben. Es antwortet mit 200, auch wenn einige abgelehnt werden, und sagt, welche.
curl -X POST "$OE/events/batch" -H "$AUTH" -H 'content-type: application/json' -d '{ "events": [ { "name": "order.placed", "email": "[email protected]" }, { "name": "order.placed", "email": "[email protected]" } ]}'{ "object": "contact_event_batch", "accepted": [{ "index": 0, "object": "contact_event", "id": "cev_6a1d9f3c8b2e40a75d9c1e38", "…": "…" }], "failed": [{ "index": 1, "code": "contact_not_found", "message": "No contact with that address. Pass createContact: true to add one." }]}index ist die Position des Ereignisses im gesendeten Array.
Ein Schlüssel oder eine App darf 600 Ereignisse pro Minute senden. Danach lautet die Antwort 429 event_rate_limited.