Перейти к документации
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 имён в алфавитном порядке.

Справочник