Dërgoni një ngjarje
Regjistron se një kontakt bëri diçka në produktin tuaj. Ngjarja nis çdo automatizim aktiv, nisësi i të cilit e emërton, dhe çon përpara këdo që po e priste.
Ekzekuton cilëndo nga 2 thirrjet në hapësirën tuaj të punës.
POST /events
Regjistron se një kontakt bëri diçka në produktin tuaj. Ngjarja nis çdo automatizim aktiv, nisësi i të cilit e emërton, dhe çon përpara këdo që po e priste.
Shembull
Kërkon contacts:write. Tregoni kontaktin me email ose me contactId.
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 ka deri në 100 shkronja, shifra, pika, dy pika, viza dhe nënvija, dhe fillon me një shkronjë ose një shifër. Emrat dallojnë shkronjat e mëdha nga të voglat.
properties mban më së shumti 50 çelësa dhe 4 KB JSON. Një filtër nisësi, një vlerë emaili dhe një degëzim mund t'i lexojnë.
occurredAt si parazgjedhje është tani. Mund të jetë deri në 90 ditë në të shkuarën dhe jo më shumë se 5 minuta në të ardhmen.
Një adresë e panjohur përgjigjet me 404 contact_not_found, përveç nëse createContact është true, gjë që e shton kontaktin, me contactName si emër të tij.
enrolled liston automatizimet ku hyri kontakti dhe resumed numëron pritjet që ngjarja u dha fund.
Dërgimi sërish i të njëjtit Idempotency-Key përgjigjet me 200 me ngjarjen e parë dhe replayed: true. I njëjti çelës me një trup tjetër refuzohet me 422 idempotency_key_reuse.
Një ngjarje e dërguar me një çelës testi ruhet me mode: "test" dhe nuk nis asgjë.
Grup
POST /events/batch merr deri në 100 ngjarje te events, secila me formën e trupit më sipër. Përgjigjet me 200 edhe kur disa refuzohen, dhe thotë cilat.
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 është pozicioni i ngjarjes në vargun që dërguat.
Një çelës ose aplikacion mund të dërgojë 600 ngjarje në minutë. Pas kësaj përgjigjja është 429 event_rate_limited.