문서로 건너뛰기
API

이벤트 읽기

연락처 하나가 한 이벤트를 최신순으로, 그리고 트리거에서 하나를 고를 수 있도록 워크스페이스가 보낸 이벤트 이름을 보여 줍니다.

GET/contacts/{email}/events

2개 호출을 워크스페이스에 실제로 실행합니다.

GET /contacts/{email}/events

연락처 하나가 한 이벤트를 최신순으로, 그리고 트리거에서 하나를 고를 수 있도록 워크스페이스가 보낸 이벤트 이름을 보여 줍니다.

예시

연락처의 이벤트에는 contacts:read가, 이벤트 이름에는 automations:read가 필요합니다. 연락처는 주소나 id로 지정합니다. name은 목록을 이벤트 하나로 좁히고, limit은 최대 200까지이며 기본값은 50입니다.

curl
curl "$OE/contacts/[email protected]/events?name=order.placed" -H "$AUTH"curl "$OE/events/names" -H "$AUTH"
응답
{  "object": "list",  "data": [{      "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"    }],  "hasMore": false,  "nextCursor": null}

90일이 지난 이벤트는 삭제되므로, 분기는 최대 90일 전까지만 돌아볼 수 있습니다.

GET /events/names는 { "object": "contact_event_name", "name": "order.placed" }의 목록으로 답하며, 이름은 알파벳순으로 최대 100개입니다.

레퍼런스