API
Read events
The events one contact did, newest first, and the event names the workspace has sent, for choosing one in a trigger.
GET/contacts/{email}/events
Runs any of 2 calls on your workspace.
GET /contacts/{email}/events
The events one contact did, newest first, and the event names the workspace has sent, for choosing one in a trigger.
Example
A contact’s events need contacts:read, and the names need automations:read. The contact is named by address or by id. name narrows the list to one event, and limit goes up to 200 and defaults to 50.
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}Events older than 90 days are deleted, so a branch can look back 90 days at most.
GET /events/names answers a list of { "object": "contact_event_name", "name": "order.placed" }, up to 100 names in alphabetical order.