ドキュメント本文へスキップ
API

イベントを読む

連絡先 1 件が行ったイベントを新しい順に返すものと、トリガーで選ぶためにワークスペースが送信したイベント名を返すものです。

GET/contacts/{email}/events

2件の呼び出しをワークスペースに対して実行します。

GET /contacts/{email}/events

連絡先 1 件が行ったイベントを新しい順に返すものと、トリガーで選ぶためにワークスペースが送信したイベント名を返すものです。

例

連絡先のイベントには contacts:read、イベント名には automations:read が必要です。連絡先はアドレスまたは id で指定します。name で一覧を 1 種類のイベントに絞り込めます。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 件です。

リファレンス