Aller à la documentation
API

Lire les événements

Les événements d'un contact, les plus récents en premier, et les noms d'événements envoyés par l'espace de travail, pour en choisir un dans un déclencheur.

GET/contacts/{email}/events

Exécute l'un des 2 appels sur votre espace de travail.

GET /contacts/{email}/events

Les événements d'un contact, les plus récents en premier, et les noms d'événements envoyés par l'espace de travail, pour en choisir un dans un déclencheur.

Exemple

Les événements d'un contact nécessitent contacts:read, et les noms automations:read. Le contact est désigné par son adresse ou par son id. name limite la liste à un seul événement, et limit monte jusqu'à 200 et vaut 50 par défaut.

curl
curl "$OE/contacts/[email protected]/events?name=order.placed" -H "$AUTH"curl "$OE/events/names" -H "$AUTH"
Réponse
{  "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}

Les événements de plus de 90 jours sont supprimés, une branche ne peut donc remonter qu'à 90 jours au plus.

GET /events/names répond une liste de { "object": "contact_event_name", "name": "order.placed" }, jusqu'à 100 noms par ordre alphabétique.

Référence