이벤트 보내기
연락처가 제품에서 무언가를 했음을 기록합니다. 이 이벤트는 트리거가 그 이벤트를 지정한 모든 게시 중 자동화를 시작하고, 그 이벤트를 기다리던 사람을 다음으로 넘깁니다.
2개 호출을 워크스페이스에 실제로 실행합니다.
POST /events
연락처가 제품에서 무언가를 했음을 기록합니다. 이 이벤트는 트리거가 그 이벤트를 지정한 모든 게시 중 자동화를 시작하고, 그 이벤트를 기다리던 사람을 다음으로 넘깁니다.
예시
contacts:write가 필요합니다. 연락처는 email 또는 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은 글자, 숫자, 마침표, 콜론, 하이픈, 밑줄로 이루어진 최대 100자이며, 글자나 숫자로 시작합니다. 이름은 대소문자를 구분합니다.
properties에는 최대 50개 키, JSON 4 KB까지 담을 수 있습니다. 트리거 필터, 이메일 값, 분기가 이를 읽을 수 있습니다.
occurredAt의 기본값은 지금입니다. 과거로는 90일까지, 미래로는 5분까지만 허용됩니다.
알 수 없는 주소는 404 contact_not_found로 답합니다. 단, createContact가 true이면 contactName을 이름으로 하여 연락처를 추가합니다.
enrolled는 연락처가 들어간 자동화를 나열하고, resumed는 그 이벤트로 끝난 대기의 수입니다.
같은 Idempotency-Key를 다시 보내면 첫 이벤트와 replayed: true를 200으로 답합니다. 같은 키에 다른 본문을 보내면 422 idempotency_key_reuse로 거부됩니다.
테스트 키로 보낸 이벤트는 mode: "test"로 저장되며 아무것도 시작하지 않습니다.
배치
POST /events/batch는 events에 이벤트를 최대 100개까지 받으며, 각각 위의 본문과 같은 모양입니다. 일부가 거부되어도 200으로 답하고 어느 것이 거부되었는지 알려 줍니다.
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는 보낸 배열에서 이벤트가 있던 위치입니다.
키나 앱은 분당 이벤트 600개를 보낼 수 있습니다. 그 이상이면 429 event_rate_limited로 답합니다.